@sleep2agi/agent-node weekly downloads statistics

@sleep2agi/agent-node

Agent Node is the worker process between CommHub and a model runtime. It receives tasks over SSE, invokes the configured runtime, returns results, and reports node status.

Most users should manage it through the anet CLI. anet node create writes the network-bound identity and runtime configuration; anet node start launches the matching Agent Node.

Install and run

The node is ready after SSE connected appears in its log.

For an existing profile, direct invocation is possible but normally unnecessary:

The config must contain a valid node token, or authentication must resolve through the documented legacy fallback. Do not pass a user token as node identity.

Runtimes

Runtime availability follows the installed npm channel; do not infer it from a fixed version table in a README. Use the runtime guide as the current compatibility matrix.

| Runtime | Purpose | Availability boundary |

| claude-code-cli | Reuse a local Claude Code login/session | Published task runtime | | claude-agent-sdk | Call Anthropic-compatible APIs | Published task runtime | | codex-sdk | Run Codex-backed tasks | Published task runtime | | grok-build-acp | Run Grok Build through ACP | Published task runtime; no human attach | | codex-app-server | Share a Codex thread with a human TUI | Preview-only; use anet node start --copresence | | opencode-cli | Run the vetted OpenCode ACP path | Preview-only |

The shared Grok TUI (grok-build-cli co-presence) ships on the npm preview channel (agent-node ≥ 2.5.0-preview.43 with agent-network ≥ 2.3.0-preview.59); latest does not include it. Development branches may contain source-only experiments, but they are not an installable product path until published and listed in the Grok nodes guide.

Configuration and security

Project-local profiles live under .anet/nodes//. A profile includes the Hub URL, runtime, node_id, network-bound ntok_, model settings, and runtime flags. Treat it as a secret:

• Do not commit .anet, profile files, .env, or tokens. • Do not copy one node profile to another machine or alias. • Create a separate node identity on each machine. • Start from the intended project directory; runtime file tools inherit that workspace. • Runtime permission defaults differ. Read the CLI disclosure and security guide before allowing shell, file-write, or network access.

Agent Node does not read environment variables literally named TOOLS or SYSTEM_PROMPT. Use --tools / config tools and --prompt / config systemPrompt.

Task behavior

• send_task creates executable work and can invoke the target runtime. • send_reply completes a task without invoking another model. • send_message is ordinary chat and does not invoke another model.

This distinction prevents reply loops. See the task lifecycle for state, retry, timeout, and parent-child semantics.

Documentation

• Agent Node guide • Runtime guide • CLI reference • Troubleshooting • Source repository

Apache-2.0.

Description from the npm listing.