| Name | henosis-cli JSON |
| Version |
0.5.10
JSON |
| download |
| home_page | None |
| Summary | henosis-cli — interactive CLI for the Henosis multi-provider streaming chat backend, with optional local tools. |
| upload_time | 2025-10-14 04:17:10 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
henosis
tools
filesystem
sandbox
patch
subprocess
cli
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Henosis CLI
the BEST terminal agent designed for uncompromising performance
Henosis CLI is a streamlined, professional terminal client for the Henosis multi-provider streaming chat backend. It supports OpenAI, Gemini, Anthropic, xAI (Grok), DeepSeek, and Moonshot Kimi via the Henosis server, and includes optional client-executed file/shell tools with approvals and sandboxing.
Key features
- Interactive chat over SSE with usage/cost summaries
- Model picker and per-turn controls (tools on/off, control level, reasoning effort)
- Client approvals at Level 2 for write/exec operations (approve once/session/always)
- Agent scope (safe host directory) when enabling tools in host mode
- Optional web search controls for OpenAI models (domain allow-list, include sources, location hints)
- Saves conversations to server threads and commits usage for billing where enabled
Install
- pip: pip install henosis-cli
- pipx (recommended): pipx install henosis-cli
Quick start
- Run the CLI: henosis-cli
- Default server: https://henosis.us/api_v2 (override with HENOSIS_SERVER or --server)
- Dev server: henosis-cli --dev (uses HENOSIS_DEV_SERVER or http://127.0.0.1:8000)
- Authenticate when prompted. Use /model to pick a model and /tools on to enable tools.
Common commands
- /menu or /settings: Open settings menu
- /model: Open settings model picker (or '/model <name>' to set directly)
- /tools on|off|default: Toggle per-request tool availability
- /fs workspace|host|default: Set filesystem scope (workspace = sandbox; host = Agent scope)
- /hostbase <abs path>: Set Agent scope root directory when fs=host
- /level 1|2|3: Control level (1 read-only; 2 write/exec with approval; 3 no approvals)
- /map on|off: Inject CODEBASE_MAP.md into your first message
- /websearch on|off|domains|sources|location: Configure OpenAI web search options
- /title <name>: Name the current chat thread
- /clear: Reset chat history
- /login, /logout, /whoami: Auth helpers
Configuration
- Server base URL
- Env: HENOSIS_SERVER (default https://henosis.us/api_v2)
- Flag: --server https://your-server
- Dev shortcut: --dev (env HENOSIS_DEV_SERVER or http://127.0.0.1:8000)
- Optional Agent Mode (developer WebSocket bridge): --agent-mode
Local tools and sandboxing (optional)
- The CLI can execute a safe subset of tools locally when the server requests client-side execution.
- Tools include read_file, write_file, append_file, list_dir, apply_patch, run_command.
- At Level 2, destructive tools and command executions prompt for approval (once/session/always).
- Workspace root: by default, the workspace scope is the current working directory at the moment you launch the CLI. No dedicated per-terminal sandbox is created unless you override it.
- Override root: set --workspace-dir /path/to/root (or HENOSIS_WORKSPACE_DIR) to operate in a different directory for the session.
- Host scope can be constrained to an Agent scope directory (set via /hostbase) when fs=host.
Notes
- Requires Python 3.9+
- The CLI ships with rich and prompt_toolkit for a nicer UI by default.
- The reusable local tools library is available as a module (henosis_cli_tools).
Anthropic-only context handoff tool (server owners)
- The server can expose a lightweight, provider-scoped function tool to Anthropic models only that lets the model signal a handoff to the next turn and carry an optional JSON payload.
- Enable by setting on the API server (not the CLI):
- ANTHROPIC_ENABLE_TONEXT_TOOL=true
- Optional: ANTHROPIC_TONEXT_TOOL_NAME=context (default) or to_next (legacy)
- Optional: ANTHROPIC_TONEXT_ATTACH_BETA=true and ANTHROPIC_TONEXT_BETA_HEADER=context-management-2025-06-27
- When enabled, clients will see normal tool.call/tool.result SSE events. The tool.result includes {"to_next": true} and echoes the provided payload.
- No client-side tool execution is required; the server handles this tool inline.
Support
- Email: henosis@henosis.us
Build and publish (maintainers)
- Bump version in pyproject.toml
- Build: python -m pip install build twine && python -m build
- Upload to PyPI: python -m twine upload dist/*
- Or to TestPyPI: python -m twine upload --repository testpypi dist/*
Raw data
{
"_id": null,
"home_page": null,
"name": "henosis-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "henosis, tools, filesystem, sandbox, patch, subprocess, cli",
"author": null,
"author_email": "henosis <henosis@henosis.us>",
"download_url": "https://files.pythonhosted.org/packages/bb/1e/cb11eba138ddc4ba2cfa9dc2c992f948e1de60bcb30bd5e9505a2001c92e/henosis_cli-0.5.10.tar.gz",
"platform": null,
"description": "# Henosis CLI\r\n\r\nthe BEST terminal agent designed for uncompromising performance\r\n\r\nHenosis CLI is a streamlined, professional terminal client for the Henosis multi-provider streaming chat backend. It supports OpenAI, Gemini, Anthropic, xAI (Grok), DeepSeek, and Moonshot Kimi via the Henosis server, and includes optional client-executed file/shell tools with approvals and sandboxing.\r\n\r\nKey features\r\n- Interactive chat over SSE with usage/cost summaries\r\n- Model picker and per-turn controls (tools on/off, control level, reasoning effort)\r\n- Client approvals at Level 2 for write/exec operations (approve once/session/always)\r\n- Agent scope (safe host directory) when enabling tools in host mode\r\n- Optional web search controls for OpenAI models (domain allow-list, include sources, location hints)\r\n- Saves conversations to server threads and commits usage for billing where enabled\r\n\r\nInstall\r\n- pip: pip install henosis-cli\r\n- pipx (recommended): pipx install henosis-cli\r\n\r\nQuick start\r\n- Run the CLI: henosis-cli\r\n- Default server: https://henosis.us/api_v2 (override with HENOSIS_SERVER or --server)\r\n- Dev server: henosis-cli --dev (uses HENOSIS_DEV_SERVER or http://127.0.0.1:8000)\r\n- Authenticate when prompted. Use /model to pick a model and /tools on to enable tools.\r\n\r\nCommon commands\r\n- /menu or /settings: Open settings menu\r\n- /model: Open settings model picker (or '/model <name>' to set directly)\r\n- /tools on|off|default: Toggle per-request tool availability\r\n- /fs workspace|host|default: Set filesystem scope (workspace = sandbox; host = Agent scope)\r\n- /hostbase <abs path>: Set Agent scope root directory when fs=host\r\n- /level 1|2|3: Control level (1 read-only; 2 write/exec with approval; 3 no approvals)\r\n- /map on|off: Inject CODEBASE_MAP.md into your first message\r\n- /websearch on|off|domains|sources|location: Configure OpenAI web search options\r\n- /title <name>: Name the current chat thread\r\n- /clear: Reset chat history\r\n- /login, /logout, /whoami: Auth helpers\r\n\r\nConfiguration\r\n- Server base URL\r\n - Env: HENOSIS_SERVER (default https://henosis.us/api_v2)\r\n - Flag: --server https://your-server\r\n - Dev shortcut: --dev (env HENOSIS_DEV_SERVER or http://127.0.0.1:8000)\r\n- Optional Agent Mode (developer WebSocket bridge): --agent-mode\r\n\r\nLocal tools and sandboxing (optional)\r\n- The CLI can execute a safe subset of tools locally when the server requests client-side execution.\r\n- Tools include read_file, write_file, append_file, list_dir, apply_patch, run_command.\r\n- At Level 2, destructive tools and command executions prompt for approval (once/session/always).\r\n- Workspace root: by default, the workspace scope is the current working directory at the moment you launch the CLI. No dedicated per-terminal sandbox is created unless you override it.\r\n- Override root: set --workspace-dir /path/to/root (or HENOSIS_WORKSPACE_DIR) to operate in a different directory for the session.\r\n- Host scope can be constrained to an Agent scope directory (set via /hostbase) when fs=host.\r\n\r\nNotes\r\n- Requires Python 3.9+\r\n- The CLI ships with rich and prompt_toolkit for a nicer UI by default.\r\n- The reusable local tools library is available as a module (henosis_cli_tools).\r\n\r\nAnthropic-only context handoff tool (server owners)\r\n- The server can expose a lightweight, provider-scoped function tool to Anthropic models only that lets the model signal a handoff to the next turn and carry an optional JSON payload.\r\n- Enable by setting on the API server (not the CLI):\r\n - ANTHROPIC_ENABLE_TONEXT_TOOL=true\r\n - Optional: ANTHROPIC_TONEXT_TOOL_NAME=context (default) or to_next (legacy)\r\n - Optional: ANTHROPIC_TONEXT_ATTACH_BETA=true and ANTHROPIC_TONEXT_BETA_HEADER=context-management-2025-06-27\r\n- When enabled, clients will see normal tool.call/tool.result SSE events. The tool.result includes {\"to_next\": true} and echoes the provided payload.\r\n- No client-side tool execution is required; the server handles this tool inline.\r\n\r\nSupport\r\n- Email: henosis@henosis.us\r\n\r\nBuild and publish (maintainers)\r\n- Bump version in pyproject.toml\r\n- Build: python -m pip install build twine && python -m build\r\n- Upload to PyPI: python -m twine upload dist/*\r\n- Or to TestPyPI: python -m twine upload --repository testpypi dist/*\r\n",
"bugtrack_url": null,
"license": null,
"summary": "henosis-cli \u2014 interactive CLI for the Henosis multi-provider streaming chat backend, with optional local tools.",
"version": "0.5.10",
"project_urls": {
"Contact": "https://henosis.us/contact",
"Homepage": "https://henosis.us"
},
"split_keywords": [
"henosis",
" tools",
" filesystem",
" sandbox",
" patch",
" subprocess",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "075da745e7dae16c69790f9663f93b5148e3dda08a18a8eacac80348eb5de86e",
"md5": "d4932b28700e59ebb0b8d035c4b387aa",
"sha256": "9acf36308715d7190ac05bf9998be6fd17d9fac0cfc0cfa594e9d290721c8c84"
},
"downloads": -1,
"filename": "henosis_cli-0.5.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d4932b28700e59ebb0b8d035c4b387aa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 105114,
"upload_time": "2025-10-14T04:17:09",
"upload_time_iso_8601": "2025-10-14T04:17:09.431425Z",
"url": "https://files.pythonhosted.org/packages/07/5d/a745e7dae16c69790f9663f93b5148e3dda08a18a8eacac80348eb5de86e/henosis_cli-0.5.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bb1ecb11eba138ddc4ba2cfa9dc2c992f948e1de60bcb30bd5e9505a2001c92e",
"md5": "a6c275f1b611cac80cc6e54917c562f2",
"sha256": "ccc0f697756989da0c5c9a362b51b4e9373a0c4281d974b69e4e12e93153d864"
},
"downloads": -1,
"filename": "henosis_cli-0.5.10.tar.gz",
"has_sig": false,
"md5_digest": "a6c275f1b611cac80cc6e54917c562f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 111036,
"upload_time": "2025-10-14T04:17:10",
"upload_time_iso_8601": "2025-10-14T04:17:10.643879Z",
"url": "https://files.pythonhosted.org/packages/bb/1e/cb11eba138ddc4ba2cfa9dc2c992f948e1de60bcb30bd5e9505a2001c92e/henosis_cli-0.5.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-14 04:17:10",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "henosis-cli"
}
