OpenHands/openhands-cli
openhands 5351702d3a Implement improved Ctrl+C handling for OpenHands CLI
- First Ctrl+C attempts graceful pause of agent
- Second Ctrl+C (within 3 seconds) kills process immediately
- Added SignalHandler and ProcessSignalHandler classes for signal management
- Implemented ProcessBasedConversationRunner for separate process execution
- Modified pause_listener to remove Ctrl+C handling (now handled by signal handler)
- Updated agent_chat.py to use process-based runner with new signal management
- Updated simple_main.py to install basic signal handler
- Added comprehensive test script and documentation

Co-authored-by: openhands <openhands@all-hands.dev>
2025-11-03 16:24:23 +00:00
..
2025-10-04 17:14:36 -04:00
2025-10-04 17:14:36 -04:00
2025-10-31 18:01:29 +00:00
2025-10-04 17:14:36 -04:00
2025-10-04 17:14:36 -04:00
2025-11-01 12:37:32 -04:00
2025-10-31 19:57:39 +00: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