github/OpenHands
1
0
Fork 0
mirror of https://github.com/OpenHands/OpenHands.git synced 2025-12-26 05:48:36 +08:00
Code Issues Packages Projects Releases Wiki Activity
OpenHands/openhands-cli
History
openhands 4068f56481 feat(cli): add working directory configuration support 
- Add working directory configuration to oh_cli_settings.json
- Implement working directory prompt at conversation start
- Add working directory settings to TUI settings screen
- Update setup_conversation to use configured directory
- Add comprehensive test coverage for working directory functionality
- Follow TUI patterns and user action confirmation patterns

Fixes #11345

Co-authored-by: openhands <openhands@all-hands.dev>
2025-10-21 16:42:08 +00:00
..
hooks
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
openhands_cli
feat(cli): add working directory configuration support
2025-10-21 16:42:08 +00:00
tests
feat(cli): add working directory configuration support
2025-10-21 16:42:08 +00:00
.gitignore
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
build.py
Fix CLI binary GLIBC compatibility for older Linux systems (#11337)
2025-10-13 18:52:52 +00:00
build.sh
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
Makefile
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
openhands.spec
[Hotfix, V1 CLI]: Include missing condenser prompt template in binary executable (#11428)
2025-10-19 18:18:23 +00:00
pyproject.toml
CLI Patch Release 1.0.2 (#11448)
2025-10-21 15:32:00 +00:00
README.md
CLI(V1) (#11220)
2025-10-04 17:14:36 -04:00
uv.lock
Use PyPI version of Agent-SDK (#11411)
2025-10-20 17:25:54 +00:00

README.md

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