@contextzero/nest 0.2.16 → 0.2.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +17 -0
  2. package/README.md +102 -0
  3. package/package.json +9 -9
package/LICENSE ADDED
@@ -0,0 +1,17 @@
1
+ NEST Software License
2
+ Copyright © 2026 Carlos Matias Baglieri
3
+
4
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use the Software for personal or internal business purposes, subject to the following conditions:
5
+
6
+ 1. Restrictions
7
+ No Modifications: The Software must be used exactly as provided. You may not alter, transform, or build upon this work.
8
+
9
+ No Redistribution: You may not redistribute, sub-license, or sell the Software to third parties without express written authorization from the owner.
10
+
11
+ Authorization: Any use case not explicitly covered by this license requires prior written consent. Please contact matias@facta.dev for authorization inquiries.
12
+
13
+ 2. Disclaimer of Warranty
14
+ 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.
15
+
16
+ 3. Limitation of Liability
17
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS (CARLOS MATIAS BAGLIERI) BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OF THE SOFTWARE. THE USERS USE THIS SOFTWARE AT THEIR OWN RISK AND RESPONSIBILITY.
package/README.md ADDED
@@ -0,0 +1,102 @@
1
+ # NEST CLI
2
+
3
+ **Enterprise AI coding agent control center.** Run Claude Code, Codex, Cursor, Gemini, and OpenCode locally—control sessions remotely from the web, PWA, or Telegram.
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@contextzero/nest.svg)](https://www.npmjs.com/package/@contextzero/nest)
6
+ [Repository](https://github.com/contextzero/nest_hub) · [Issues](https://github.com/contextzero/nest_hub/issues) · [License](https://github.com/contextzero/nest_hub/blob/main/LICENSE) (AGPL-3.0-only)
7
+
8
+ ---
9
+
10
+ ## Features
11
+
12
+ - **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.
13
+ - **Remote control** — Monitor and steer sessions from the web app or Telegram Mini App. Approve permissions, send messages, and run commands from any device.
14
+ - **Background worker** — Run a worker so sessions can be started remotely without keeping a terminal open. Machines stay available in the NEST dashboard.
15
+ - **Project automation** — OpenClaw and ZeroClaw integrate for orchestration and task graphs at scale (see [docs](https://github.com/contextzero/nest_hub)).
16
+ - **MCP bridge** — Expose tools to external clients via the MCP stdio bridge.
17
+ - **Enterprise-ready** — Server-side LLM config (OpenRouter, Vertex, DeepInfra), centralized events, and diagnostics.
18
+
19
+ ---
20
+
21
+ ## Install
22
+
23
+ ```bash
24
+ npm install -g @contextzero/nest
25
+ ```
26
+
27
+ The package installs the native binary for your platform (Linux, macOS, Windows) via optional dependencies.
28
+
29
+ ---
30
+
31
+ ## Quick start
32
+
33
+ 1. **Start the NEST server** and set `CLI_API_TOKEN` (see [server setup](https://github.com/contextzero/nest_hub)).
34
+ 2. **On this machine:** set the same `CLI_API_TOKEN` (env or `annie auth login`).
35
+ 3. **Run a session:**
36
+ ```bash
37
+ annie # Claude Code
38
+ annie cursor # Cursor Agent
39
+ annie codex # Codex (OpenAI)
40
+ annie opencode # OpenCode
41
+ annie gemini # Gemini (ACP)
42
+ ```
43
+ 4. Open the **web app** or **Telegram Mini App** to monitor and control.
44
+
45
+ ---
46
+
47
+ ## Commands
48
+
49
+ | Area | Command | Description |
50
+ |------|---------|-------------|
51
+ | **Sessions** | `annie` | Start Claude Code (forwards Claude CLI flags). |
52
+ | | `annie codex` | Codex mode. Use `annie codex resume <sessionId>` to resume. |
53
+ | | `annie cursor` | Cursor Agent. Supports `--continue`, `--mode plan\|ask`, `--yolo`, `--model`. |
54
+ | | `annie gemini` | Gemini via ACP (remote mode). |
55
+ | | `annie opencode` | OpenCode via ACP. Local and remote. |
56
+ | **Auth** | `annie auth status` | Show auth config and token source. |
57
+ | | `annie auth login` | Save `CLI_API_TOKEN` interactively. |
58
+ | | `annie auth logout` | Clear saved credentials. |
59
+ | **Worker** | `annie worker start` | Start worker (detached). |
60
+ | | `annie worker stop` | Stop worker. |
61
+ | | `annie worker status` | Worker diagnostics. |
62
+ | | `annie worker list` | Active sessions. |
63
+ | **Other** | `annie diagnose` | Full diagnostics (version, worker, logs). |
64
+ | | `annie diagnose clean` | Kill runaway NEST processes. |
65
+ | | `annie mcp` | Start MCP stdio bridge. |
66
+ | | `annie server` | Start the bundled server (single-binary). |
67
+
68
+ ---
69
+
70
+ ## Configuration
71
+
72
+ | Variable | Required | Description |
73
+ |----------|----------|-------------|
74
+ | `CLI_API_TOKEN` | Yes | Shared secret; must match the server. Env or `~/.nest/settings.json`. |
75
+ | `NEST_API_URL` | No | Server URL (default: `http://localhost:8080`). |
76
+ | `NEST_HOME` | No | Config directory (default: `~/.nest`). |
77
+ | `NEST_CLAUDE_PATH` | No | Path to `claude` executable. |
78
+ | `NEST_HTTP_MCP_URL` | No | Default MCP target for `annie mcp`. |
79
+
80
+ Worker: `NEST_RUNNER_HEARTBEAT_INTERVAL`, `NEST_RUNNER_HTTP_TIMEOUT`.
81
+
82
+ ---
83
+
84
+ ## Requirements
85
+
86
+ - **Claude Code** on PATH for `annie`.
87
+ - **Cursor Agent** on PATH for `annie cursor`: install from [Cursor](https://cursor.com).
88
+ - **OpenCode** on PATH for `annie opencode` (when used).
89
+
90
+ ---
91
+
92
+ ## Documentation
93
+
94
+ - [Repository & guides](https://github.com/contextzero/nest_hub)
95
+ - [Installation & deployment](https://github.com/contextzero/nest_hub#readme)
96
+ - [Issues & support](https://github.com/contextzero/nest_hub/issues)
97
+
98
+ ---
99
+
100
+ ## License
101
+
102
+ AGPL-3.0-only. See [LICENSE](https://github.com/contextzero/nest_hub/blob/main/LICENSE) in the repository.
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "@contextzero/nest",
3
- "version": "0.2.16",
3
+ "version": "0.2.24",
4
4
  "description": "NEST CLI - Enterprise AI coding agent control center. Run Claude Code, Codex, Cursor, Gemini, OpenCode locally and control remotely via web.",
5
5
  "author": "Carlos Matias Baglieri",
6
6
  "license": "AGPL-3.0-only",
7
7
  "type": "module",
8
- "homepage": "https://github.com/Facta-Dev/ctx0_nest_terminal",
9
- "bugs": "https://github.com/Facta-Dev/ctx0_nest_terminal/issues",
8
+ "homepage": "https://github.com/contextzero/nest_hub",
9
+ "bugs": "https://github.com/contextzero/nest_hub/issues",
10
10
  "repository": {
11
11
  "type": "git",
12
- "url": "git+https://github.com/Facta-Dev/ctx0_nest_terminal.git",
12
+ "url": "git+https://github.com/contextzero/nest_hub.git",
13
13
  "directory": "cli"
14
14
  },
15
15
  "bin": {
@@ -26,10 +26,10 @@
26
26
  "README.md"
27
27
  ],
28
28
  "optionalDependencies": {
29
- "@contextzero/nest-darwin-arm64": "0.2.16",
30
- "@contextzero/nest-darwin-x64": "0.2.16",
31
- "@contextzero/nest-linux-arm64": "0.2.16",
32
- "@contextzero/nest-linux-x64": "0.2.16",
33
- "@contextzero/nest-win32-x64": "0.2.16"
29
+ "@contextzero/nest-darwin-arm64": "0.2.24",
30
+ "@contextzero/nest-darwin-x64": "0.2.24",
31
+ "@contextzero/nest-linux-arm64": "0.2.24",
32
+ "@contextzero/nest-linux-x64": "0.2.24",
33
+ "@contextzero/nest-win32-x64": "0.2.24"
34
34
  }
35
35
  }