openhands 1.3.0__py3-none-any.whl

openhands-1.3.0.dist-info/METADATA

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: openhands
+Version: 1.3.0
+Summary: OpenHands CLI - Terminal User Interface for OpenHands AI Agent
+Author-email: OpenHands Team <contact@all-hands.dev>
+License: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: ==3.12.*
+Requires-Dist: agent-client-protocol>=0.6.3
+Requires-Dist: openhands-sdk==1.3.0
+Requires-Dist: openhands-tools==1.3.0
+Requires-Dist: prompt-toolkit>=3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: typer>=0.17.4
+Description-Content-Type: text/markdown
+
+# OpenHands V1 CLI
+
+A **lightweight, modern CLI** to interact with the OpenHands agent (powered by [OpenHands Software Agent SDK](https://github.com/OpenHands/software-agent-sdk)).
+
+---
+
+## Quickstart
+
+- Prerequisites: Python 3.12+, curl
+- Install uv (package manager):
+
+  ```bash
+  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
+
+```bash
+make install
+
+# Start the CLI
+make run
+# or
+uv run openhands
+```
+
+### Build a standalone executable
+
+```bash
+# Build (installs PyInstaller if needed)
+./build.sh --install-pyinstaller
+
+# The binary will be in dist/
+./dist/openhands            # macOS/Linux
+# dist/openhands.exe        # Windows
+```

openhands-1.3.0.dist-info/RECORD

@@ -0,0 +1,43 @@
+openhands_cli/__init__.py,sha256=OOEyXT_0NA9j-_8JxHrNviJnxq5XBOG2G2qMeJYqSuI,188
+openhands_cli/agent_chat.py,sha256=A3Goz9S2doDsXz0Izh-fKttRsLtWHAeiKwAz4w7eDiI,7903
+openhands_cli/gui_launcher.py,sha256=4R5BtSID6BHM_6BATvXcXD_DzGLgr1JkZGNFM2fm8aQ,7245
+openhands_cli/locations.py,sha256=JaSSf6_X9hYztjlah46aYvn7DgM-nvXwemPQ8-UymXA,439
+openhands_cli/pt_style.py,sha256=ppW6OTlhsXTQeZBnHRvRjkBboAukGo6e6gT5E3M8nCU,1296
+openhands_cli/runner.py,sha256=UuyBdhK_9dOOlLlxjMjwCqcsmeL-CSgt1GxZADgTRe0,6398
+openhands_cli/setup.py,sha256=wi9-1EXOKxdD0swa9piAlIq3hSgqb8tRqc74yHO0pWE,4637
+openhands_cli/simple_main.py,sha256=HoPRXd9o2Z7cSk2zbwxMpPskaeJ9rjePOJfVMsH5Xs0,2079
+openhands_cli/utils.py,sha256=kuIFkguoFdXM7srXClLgbL_Hk3ma1oR4ojs0Vq9_MRc,3454
+openhands_cli/version_check.py,sha256=oLRnL2vso0-zmj4hLwXs-aBDrw2r7FllV0TELUuowFo,2339
+openhands_cli/acp_impl/README.md,sha256=4SV8XTnGF6ey7U_rPMl2vKonFHRyZZ5weWCyKvtanok,1808
+openhands_cli/acp_impl/__init__.py,sha256=wmjE30vECeQBesqXPxMZQt5kbsiqs6GGcR84sK2scC8,60
+openhands_cli/acp_impl/agent.py,sha256=Nj0J_oiF8VTUuHwXACwJ7xC615AWNWP4BG7YYFvSQVs,18068
+openhands_cli/acp_impl/event.py,sha256=YSAg3i9RsZ712nwx6WvKUoCKqlxhrqhtyaosmvrj-R4,19375
+openhands_cli/acp_impl/main.py,sha256=y8XdBcVWBoLnZEKV9FGnz9GXjEveD2C9S-mAVue5N28,402
+openhands_cli/acp_impl/test_utils.py,sha256=RdChYOXaa3m-NIiOp4lSo36TR9wIvsd54wo8V1DTiHQ,4932
+openhands_cli/acp_impl/utils/__init__.py,sha256=rbZuhTDwFCLztuRlPLz60A9ojjdYgCcu6TP3HTDG6RI,423
+openhands_cli/acp_impl/utils/convert.py,sha256=4Ot7piq1usfcZFBJqmOmhetodqQdhsHCNV2klEJu_tg,3622
+openhands_cli/acp_impl/utils/mcp.py,sha256=ojjhzdjXOS8hcokk6tFPNfvi1IwJi__3cj8xg06pVqk,2064
+openhands_cli/acp_impl/utils/resources.py,sha256=B6mCd4WINePy9ioZkJNSuQeensOLZP0C9pDPNIyeQ34,6687
+openhands_cli/argparsers/main_parser.py,sha256=kTi0A4quWP-4ct4nTBRRcpJxl9daPn9gYsuODn0NnYY,2540
+openhands_cli/argparsers/serve_parser.py,sha256=XEZolYh9785rCn5873jelwo9wQAPe8TpKCT6USh5oQQ,892
+openhands_cli/listeners/__init__.py,sha256=WPp6gg1Xo4Ms87nOAnnHrrB_JQHU6tbPyANsu1r6ofY,95
+openhands_cli/listeners/pause_listener.py,sha256=VF814vftAsMw3MUg50jNlR7orAT7lfK0Ug5W_65ffHw,2622
+openhands_cli/tui/__init__.py,sha256=u3C2-KMUwc0FCgzy252qQZ6e8-fryQaFayrXFH99NPM,85
+openhands_cli/tui/status.py,sha256=mmum5q8bj0c1p4oWacqKuGqrEhTh83VO00y7_VPPVTs,3631
+openhands_cli/tui/tui.py,sha256=_maGy9QdQbILcbu7p1R7UuoeuyppO8JPlZBNsBiWP5E,4191
+openhands_cli/tui/utils.py,sha256=0FwckO1StXmYNhd5rIgqA1wfuFVHTQTts8lmxwfG25w,536
+openhands_cli/tui/visualizer.py,sha256=H8_AWZcuG_VzGIxdCu2MfCGLoihSRi_OqwW1fI0UDAQ,775
+openhands_cli/tui/settings/mcp_screen.py,sha256=TJIN33SWS6NmVRJsWaELQ-ym3pv3gAkV8Bwd4eZ23g0,8369
+openhands_cli/tui/settings/settings_screen.py,sha256=rFjSrdC9b10BzSivSnh9DWrO_lxGBaX2ZGAR_bGQZvg,7616
+openhands_cli/tui/settings/store.py,sha256=2mZgYXXRnznTiE-pylg1OJZY8Y7Yruyr2sMEsUg-VaQ,5007
+openhands_cli/user_actions/__init__.py,sha256=JXVhV9rAbr3Iu5Oe2pCfJDyXGJsGMraIGdE0nXB9-zg,502
+openhands_cli/user_actions/agent_action.py,sha256=U9eOuL7ILzJplTmDbNFc9DdxSxvctwXMQvCVtaJF6zE,2756
+openhands_cli/user_actions/exit_session.py,sha256=sddcUgIU8x0ZlLl3tDqJC6y9bWARBKaWZPDWYM6Fi28,624
+openhands_cli/user_actions/settings_action.py,sha256=MxSJKBwG9ZLxUN2SoHM8rkFHoaVHS8kXJaoNNkFK3Yc,5816
+openhands_cli/user_actions/types.py,sha256=9fQt-WzFEdNx1Jzzw2GzOh6eUHKXcbD0tEcPKYWDDvU,376
+openhands_cli/user_actions/utils.py,sha256=wkCyneUaZis2QEzy_N5sZKfVz-UY5UCvtgIskpNjWXg,6341
+openhands-1.3.0.dist-info/METADATA,sha256=aIA-yesnIzYkMkmtooGqxMFEITOlgpGlVCvpt4lS_Uc,1388
+openhands-1.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+openhands-1.3.0.dist-info/entry_points.txt,sha256=osuGbXdgR0j4VVjADhmI1rJVdLaIC_msiX7N2p0gwpk,100
+openhands-1.3.0.dist-info/licenses/LICENSE,sha256=CMN1TvlWHkk2fclMEclStpUdNUO8J8CtnY1MWUOiBXs,1069
+openhands-1.3.0.dist-info/RECORD,,

openhands-1.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

openhands-1.3.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+openhands = openhands_cli.simple_main:main
+openhands-acp = openhands_cli.acp:main

openhands-1.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 All Hands AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

openhands_cli/__init__.py

@@ -0,0 +1,9 @@
+"""OpenHands package."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+
+try:
+    __version__ = version("openhands")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

openhands_cli/acp_impl/README.md

@@ -0,0 +1,68 @@
+# ACP Implementation
+
+## What is the Agent Client Protocol (ACP)?
+
+The [Agent Client Protocol (ACP)](https://agentclientprotocol.com/protocol/overview) is a standardized communication protocol that enables code editors and IDEs to interact with AI agents. ACP defines how clients (like code editors) and agents (like OpenHands) communicate through a JSON-RPC 2.0 interface.
+
+For more details about the protocol, see the [ACP documentation](https://agentclientprotocol.com/protocol/overview).
+
+## Development Guide
+
+### Setup with Zed IDE
+
+Follow the documentation at [OpenHands ACP Guide](https://docs.openhands.dev/openhands/usage/run-openhands/acp#zed-ide) for general setup instructions.
+
+#### Option 1: Test with PR Branch
+
+Add this agent configuration to test with the PR branch:
+
+```json
+"OpenHands-uvx": {
+  "command": "uvx",
+  "args": [
+    "--from",
+    "git+https://github.com/OpenHands/OpenHands-CLI.git@xw/acp-simplification",
+    "openhands",
+    "acp"
+  ],
+  "env": {}
+}
+```
+
+#### Option 2: Launch Local Instance
+
+Use this configuration to run your local development version:
+
+```json
+"OpenHands-local": {
+  "command": "uv",
+  "args": [
+    "run",
+    "--project",
+    "/YOUR_LOCAL_PATH/OpenHands-CLI",
+    "openhands",
+    "acp"
+  ],
+  "env": {}
+}
+```
+
+### Debugging
+
+In Zed IDE, open ACP logs before starting a conversation:
+- Press `Cmd+Shift+P`
+- Search for **"dev: open acp log"**
+- This visualizes all events between the ACP server and client
+
+### Testing with JSON-RPC CLI
+
+To reproduce errors or test manually, send JSON-RPC events directly using the test script:
+
+```bash
+uv run python scripts/acp/jsonrpc_cli.py ./dist/openhands acp
+```
+
+This interactive CLI allows you to:
+- Send JSON-RPC messages as single lines
+- View stdout/stderr responses
+- Exit with `:q`, `:quit`, or `:exit`

openhands_cli/acp_impl/__init__.py

@@ -0,0 +1 @@
+"""OpenHands Agent Client Protocol (ACP) Implementation."""