OpenHands/openhands-cli
openhands 3bbffa1769 Merge branch 'main' into feature/cli-conversation-list
Resolved merge conflicts by:
- Keeping main's versions of files that were deleted or moved
- Re-applying PR changes to agent_chat.py and tui.py
- Maintaining all PR functionality (conversation listing, loading, and completion)

PR files preserved:
- openhands-cli/openhands_cli/conversation_manager.py
- openhands-cli/tests/test_conversation_manager.py

Modified files with PR changes re-applied:
- openhands-cli/openhands_cli/agent_chat.py
- openhands-cli/openhands_cli/tui/tui.py

Co-authored-by: openhands <openhands@all-hands.dev>
2025-11-13 16:24:44 +00:00
..
2025-10-04 17:14:36 -04:00
2025-10-04 17:14:36 -04:00
2025-10-04 17:14:36 -04:00
2025-11-11 16:46:30 -05:00
2025-11-01 12:37:32 -04:00
2025-11-11 16:46:30 -05:00

OpenHands V1 CLI

A lightweight, modern CLI to interact with the OpenHands agent (powered by OpenHands software-agent-sdk).


Quickstart

  • Prerequisites: Python 3.12+, curl
  • Install uv (package manager):
    curl -LsSf https://astral.sh/uv/install.sh | sh
    # Restart your shell so "uv" is on PATH, or follow the installer hint
    

Run the CLI locally

make install

# Start the CLI
make run
# or
uv run openhands

Build a standalone executable

# Build (installs PyInstaller if needed)
./build.sh --install-pyinstaller

# The binary will be in dist/
./dist/openhands            # macOS/Linux
# dist/openhands.exe        # Windows