Henosis CLI
Henosis CLI is a multi-provider coding agent for your terminal.
Use frontier models from every major provider in one workflow, point them at your codebase, and keep work connected across the CLI, Henosis Chat, and Remote Control. Bring your own API keys, use your Codex subscription where supported, or run on Henosis credits.
Why Henosis CLI
- Work across providers without vendor lock-in
- Let agents read files, apply patches, and run commands with configurable controls
- Continue the same threads between browser, terminal, and remote sessions
- Monitor and steer active sessions from the web with Remote Control
What it does
Henosis CLI gives you a connected coding workflow across terminal and web.
With Henosis CLI, you can:
- chat with leading models from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, and more
- switch models as a task evolves instead of committing to a single provider
- run long-lived coding sessions against your repository
- review and approve sensitive actions before they execute
- keep threads, context, and billing connected with the Henosis web app
- monitor active CLI sessions remotely with
--agent-mode
Core capabilities
- Interactive chat over SSE with usage and cost summaries
- Model picker and per-turn controls
- Local tool execution with configurable approval levels
- Workspace and host-scope filesystem controls
- Optional web search controls for supported OpenAI models
- Thread persistence and usage tracking through the Henosis backend
- Remote Control support for monitoring and steering active terminal sessions
Install
- pip:
pip install henosis-cli
- pipx:
pipx install henosis-cli
Quick start
- Run the CLI:
henosis-cli
- Default server:
https://henosis.us/api_v2
- Override server:
henosis-cli --server https://your-server
- Dev server:
henosis-cli --dev
When prompted, sign in and choose a model. Tools are enabled by default.
Common commands
/menuor/settings— open settings/model— open the model picker/model <name>— set a model directly/tools on|off|default— toggle tool availability/fs workspace|host|default— choose filesystem scope/hostbase <abs path>— set the host scope root/level 1|2|3— choose approval level/map on|off— injectCODEBASE_MAP.mdinto the first message/websearch on|off|domains|sources|location— configure web search options/title <name>— rename the current thread/clear— clear chat history/login,/logout,/whoami— auth helpers
Gemini 3.6 Flash
The backend and CLI support gemini-3.6-flash with a 1,048,576-token context
window and 65,536-token maximum output. Standard pricing per 1M tokens is
$1.50 input, $0.15 cached input, and $7.50 output (including thinking tokens).
Supported thinking levels are minimal, low, medium, and high. Gemini
3.6 requests omit the deprecated temperature, topP, and topK parameters.
Configuration
Server URL
- Env:
HENOSIS_SERVER
- Flag:
--server
- Dev shortcut:
--devusesHENOSIS_DEV_SERVERorhttp://127.0.0.1:8000
Agent Mode
- Enable remote session connectivity with:
--agent-mode
Local tools and approvals
Henosis CLI can execute a controlled set of local tools when requested by the server.
Available tool categories include:
- file reading and writing
- directory listing
- patch application
- command execution
- managed background processes
- managed interactive terminals
Approval levels:
- Level 1 — read-only
- Level 2 — write and exec actions require approval
- Level 3 — unrestricted local execution
Filesystem modes:
- workspace — sandboxed to the current working directory by default
- host — restricted to a chosen Agent scope directory
You can also override the workspace root with:
--workspace-dir /path/to/rootHENOSIS_WORKSPACE_DIR=/path/to/root
Remote Control
Henosis CLI supports a connected remote workflow through Agent Mode.
Start the CLI with:
henosis-cli --agent-mode
Then open Remote Control at:
https://henosis.us/agent
From there, you can:
- monitor active sessions
- review terminal state
- send follow-up instructions
- handle approvals from the web
- reconnect without losing session continuity
Troubleshooting
If a provider streams deltas but never sends a final message.completed, the CLI prints a diagnostics block with:
- stream stats
- recent event tail
- relevant response headers
It also writes the same information to:
logs/session-*.jsonl
Useful flags and environment variables:
--debug-sse--debug-reqHENOSIS_CLI_SSE_TAIL=80
Minimal test harness:
python test_stream.py
Optional overrides:
HENOSIS_TEST_URLHENOSIS_TEST_MODELHENOSIS_TEST_PROMPT
Requirements
- Python 3.9+
- Rich terminal support is included by default
- The reusable local tools library is available as
henosis_cli_tools
Support
- Email:
henosis@henosis.us
1 maintainer
Release files for henosis-cli 0.6.174
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| henosis_cli-0.6.174.tar.gz | 956.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| henosis_cli-0.6.174-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
Total release size: 3.5 MB
Release files / henosis_cli-0.6.174.tar.gz
| Download URL | henosis_cli-0.6.174.tar.gz |
|---|---|
| Size | 956.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1a08e87bd1cfa234831e2ef68c7d7bc089ddb87398569eaab6a82c2dfff8a313
|
|
BLAKE2b-256 checksum How to use checksums |
6d5cfbaff330081c9b2f87bc180a154364a52132cc8f832643e76782455fe53d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
Release files / henosis_cli-0.6.174-py3-none-win_amd64.whl
| Download URL | henosis_cli-0.6.174-py3-none-win_amd64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f74dee75ddcc8ff90a981d7cff8486b02d7b67617ed2e54bff1ba2945e0b057a
|
|
BLAKE2b-256 checksum How to use checksums |
a2f3e498e5d4d7038661efdc9f1d8cea4f245da175d8340b7870d77b2005f7f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
