OpenHands/openhands-cli

OpenHands V1 CLI

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

The OpenHands V0 CLI (legacy) is being deprecated.

---

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