@contextzero/nest
v0.2.61
Published
NEST CLI - Enterprise AI coding agent control center. Run Claude Code, Codex, Cursor, Gemini, OpenCode locally and control remotely via web.
Readme
NEST CLI
Enterprise AI coding agent control center. Run Claude Code, Codex, Cursor, Gemini, and OpenCode locally—control sessions remotely from the web, PWA, or Telegram.
Repository · Issues · License (AGPL-3.0-only)
Features
- Unified AI coding — One CLI for Claude Code, Codex, Cursor Agent, Gemini, OpenCode, and KiloCode. Sessions sync with the NEST server for remote access and audit.
- Remote control — Monitor and steer sessions from the web app or Telegram Mini App. Approve permissions, send messages, and run commands from any device.
- Background worker — Run a worker so sessions can be started remotely without keeping a terminal open. Machines stay available in the NEST dashboard.
- Project automation — OpenClaw and ZeroClaw integrate for orchestration and task graphs at scale (see docs).
- MCP bridge — Expose tools to external clients via the MCP stdio bridge.
- Enterprise-ready — Server-side LLM config (OpenRouter, Vertex, DeepInfra), centralized events, and diagnostics.
Install
npm install -g @contextzero/nestThe package installs the native binary for your platform (Linux, macOS, Windows) via optional dependencies.
Quick start
- Start the NEST server and set
CLI_API_TOKEN(see server setup). - On this machine: set the same
CLI_API_TOKEN(env orannie auth login). - Run a session:
annie # Claude Code annie cursor # Cursor Agent annie codex # Codex (OpenAI) annie opencode # OpenCode annie gemini # Gemini (ACP) - Open the web app or Telegram Mini App to monitor and control.
Commands
| Area | Command | Description |
|------|---------|-------------|
| Sessions | annie | Start Claude Code (forwards Claude CLI flags). |
| | annie codex | Codex mode. Use annie codex resume <sessionId> to resume. |
| | annie cursor | Cursor Agent. Supports --continue, --mode plan\|ask, --yolo, --model. |
| | annie gemini | Gemini via ACP (remote mode). |
| | annie opencode | OpenCode via ACP. Local and remote. |
| Auth | annie auth status | Show auth config and token source. |
| | annie auth login | Save CLI_API_TOKEN interactively. |
| | annie auth logout | Clear saved credentials. |
| Worker | annie worker start | Start worker (detached). |
| | annie worker stop | Stop worker. |
| | annie worker status | Worker diagnostics. |
| | annie worker list | Active sessions. |
| Other | annie diagnose | Full diagnostics (version, worker, logs). |
| | annie diagnose clean | Kill runaway NEST processes. |
| | annie mcp | MCP stdio bridge: --url <mcp-url>; token via --token / --bearer or CLI_API_TOKEN / NEST_MCP_BEARER_TOKEN. |
| | annie server | Start the bundled server (single-binary). |
Configuration
| Variable | Required | Description |
|----------|----------|-------------|
| CLI_API_TOKEN | Yes | Shared secret; must match the server. Env or ~/.nest/settings.json. |
| NEST_API_URL | No | Server URL (default: http://localhost:8080). |
| NEST_HOME | No | Config directory (default: ~/.nest). |
| NEST_CLAUDE_PATH | No | Path to claude executable. |
| NEST_HTTP_MCP_URL | No | Default MCP target for annie mcp. |
| NEST_REMOTE_AGENT_INK | No | Set to 1 for the full-screen Ink panel in remote mode (Space→local, Ctrl-C). If unset, remote is headless but Claude still mirrors turns to stdout so the terminal shows web-driven activity. prepareStdinForLocalShell runs before each local pass so the console accepts input after remote. |
Worker: NEST_RUNNER_HEARTBEAT_INTERVAL, NEST_RUNNER_HTTP_TIMEOUT.
Requirements
- Claude Code on PATH for
annie. - Cursor Agent on PATH for
annie cursor: install from Cursor. - OpenCode on PATH for
annie opencode(when used).
Documentation
License
AGPL-3.0-only. See LICENSE in the repository.
