CLI Command Reference

anet is the Agent Network command-line management tool for Hub, account, Network, Agent Node, monitoring, and Demo operations.

Installation

bash

npm install -g @sleep2agi/agent-network@preview

After installation, the anet command is available globally.

Command Overview

Quick Start

Command	Description	Status
`anet init`	Configure hub address	verified
`anet init project`	Configure Claude Code project (.mcp.json + CLAUDE.md)	verified
`anet quickstart`	Legacy one-click setup	unverified / not recommended

Server Management

Command	Description
`anet hub start`	Start CommHub Server
`anet hub dashboard`	Start Dashboard UI
`anet hub config`	View/change Hub config

Account Management

Command	Description
`anet register`	Register an account
`anet login`	Log in
`anet whoami`	View current user
`anet passwd`	Change password

Network Management

Command	Description
`anet network ls`	List networks
`anet network create <name>`	Create a network
`anet network use <name>`	Switch active network
`anet network info <name>`	View network details
`anet network rename <old> <new>`	Rename a network
`anet network delete <name>`	Delete a network
`anet network invite`	Create an invite code for the current network
`anet network join <invite_code>`	Join a network with an invite code

Token Management

Command	Description
`anet token create <name>`	Create an API token
`anet token ls`	List all tokens
`anet token revoke <id>`	Revoke a token

Agent Node Management

Command	Description
`anet node create <name>`	Create an agent node
`anet node start <name>`	Start an agent
`anet node stop <name>`	Stop an agent
`anet node resume <name>`	Resume previous session
`anet node ls`	List all nodes
`anet info <name>`	View agent details
`anet logs <name>`	View agent logs
`anet node rename <old> <new>`	Rename an agent
`anet node delete <name>`	Delete an agent

Monitoring

Command	Description
`anet status`	Network overview (online agents + task stats)
`anet tasks [status]`	View task list
`anet demo ls`	List available demos
`anet demo debate [opts]`	Debate demo: 6 roles and a 9-step debate flow
`anet demo monitor [--live]`	Terminal dashboard (keeps the old `anet demo --live` alias)
`anet doctor`	System diagnostics

See Debate Demo for the runnable multi-agent demo.

Channel Management

Command	Description
`anet channel add <type>`	Add a channel (telegram/wechat/feishu)
`anet channel ls`	List channels

Other

Command	Description
`anet config`	View/modify configuration
`anet license`	View license status
`anet activate <key>`	Activate a license

Detailed Usage

anet hub start

Start the CommHub communication server.

bash

anet hub start [options]

What it does:

Generates COMMHUB_AUTH_TOKEN on first run and saves it to ~/.anet/server/config.json
Starts CommHub on 127.0.0.1:9200 by default
Creates the SQLite database at ~/.commhub/commhub.db
Creates the default admin account on first run (admin / anethub)
Saves the local Hub URL to ~/.anet/config.json
Reuses a valid saved utok_ if one exists; otherwise run anet login

Parameter	Default	Description
`--port`	9200	Listen port
`--token`	(auto-generated)	Bearer auth token
`--host` / `--ip`	127.0.0.1	Bind address; use `0.0.0.0` for LAN access
`--username`	admin	Default account username
`--password`	anethub	Default account password

Environment variables:

Variable	Description
`PORT`	Listen port
`COMMHUB_AUTH_TOKEN`	Global auth token
`DATABASE_URL`	PostgreSQL connection (optional, defaults to SQLite)
`COMMHUB_CORS_ORIGINS`	CORS whitelist

anet node create

Create a new agent node.

bash

anet node create <name> [options]

Parameter	Default	Description
`--runtime`	(interactive)	`claude-agent-sdk` / `codex-sdk` / `claude-code-cli`
`--model`	(per runtime default)	Model name

Examples:

bash

# Interactive creation
anet node create my-agent

# Direct specification
anet node create code-assistant --runtime codex-sdk --model gpt-5.4

# MiniMax Agent
anet node create translator --runtime claude-agent-sdk --model MiniMax-M2.7

After creation, a config file is generated at .anet/nodes/<node_id>/config.json:

json

{
  "anet_version": "0.1.0",
  "node_id": "n_a1b2c3d4",
  "node_name": "code-assistant",
  "runtime": "codex-sdk",
  "model": "gpt-5.4",
  "session": "",
  "channels": ["server:commhub"],
  "tools": [],
  "env": {},
  "flags": {
    "dangerouslySkipPermissions": true,
    "teammateMode": "in-process",
    "maxTurns": 20,
    "logLevel": "info"
  }
}

anet node start

Start an agent node.

bash

anet node start <name> [options]

Parameter	Default	Description
`--new-session`	false	Ignore previous session, create a new one

Flow:

Read .anet/nodes/<name>/config.json
Auto-populate node_id (if missing)
Start tmux session
Spawn agent process (based on runtime)
Connect to CommHub (report_status(idle))
Establish SSE long connection
Wait for tasks

anet status

View network status overview.

bash

anet status

Example output:

Agent Network Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Network: default (net_a1b2c3d4)
Server:  http://localhost:9200

Nodes (5 online, 2 offline):
  🟢 commander    idle     Claude      3s ago
  🟢 coder-1     working  Codex (codex-sdk)     Writing sorting algorithm
  🟢 coder-2     idle     Codex (codex-sdk)     15s ago
  🟢 writer-1    idle     MiniMax     1m ago
  🟢 writer-2    idle     MiniMax     2m ago
  ⚪ tester-1    offline              2h ago
  ⚪ tester-2    offline              3h ago

Tasks: 42 replied, 3 running, 0 failed

anet tasks

View task list.

bash

anet tasks [status] [--limit <n>]

Parameter	Description
`status`	Filter by status: `delivered` / `running` / `replied` / `failed` / `cancelled`
`--limit`	Number of items (default 20)

Examples:

bash

# View all tasks
anet tasks

# Show only failed tasks
anet tasks failed

# Limit item count
anet tasks --limit 5

anet doctor

System diagnostics.

bash

anet doctor

Checks:

Global config (~/.anet/config.json)
Auth token presence
Hub reachability (GET /health)
Local node config and process status
Claude / Codex / Bun dependencies
Current project .mcp.json commhub config

anet network invite

Create a network invite code.

bash

anet network invite [options]

Parameter	Default	Description
`--role`	member	Invited role: `admin` / `member` / `viewer`
`--uses`	1	Maximum uses, -1 for unlimited
`--expires`	(none)	Expiration in days

Examples:

bash

# Switch to the target network first
anet network use dev

# Create a single-use invite code
anet network invite

# Create a 10-use member invite code
anet network invite --role member --uses 10

# Create a 7-day expiring viewer invite code
anet network invite --role viewer --expires 7

anet token create

Create an API token.

bash

anet token create <name>

Examples:

bash

# Create an API token
anet token create my-agent-token

Security Note

The created token is displayed only once. Store it securely. If lost, you'll need to create a new one.

anet node resume

Resume a previously interrupted agent session. When an agent crashes, is manually stopped, or exits unexpectedly, use this command to restore context without losing conversation history.

bash

anet node resume <name> [--session <id>]

Parameter	Description
`<name>`	Agent name (alias)
`--session`	Specify a session ID to resume (optional)

If --session is not specified, the last session saved in config.json is used.

Automatic session saving:

After each task completion, Agent Node automatically saves the session_id (Claude) or thread_id (Codex) to the session field in config.json
On the next anet node resume, this is read automatically -- no manual tracking needed

Use cases:

Agent process crashed or was killed, need to restore context and continue working
After a manual anet node stop, want to continue where the previous conversation left off
Network disconnect caused the agent to go offline, resume after reconnecting

bash

# Resume last session
anet node resume commander

# Resume a specific session
anet node resume worker --session abc123

Difference from anet node start

anet node start creates a new session by default. If you want to restore an old session, use anet node resume. If you want to force a new session, use anet node start <name> --new-session.

anet init project

Initialize a Claude Code project with automatic MCP and CLAUDE.md configuration.

bash

anet init project

Auto-created files:

{project}/
├── .mcp.json            # MCP Server config
├── CLAUDE.md            # Agent behavior rules
└── .anet/
    ├── node-server.ts   # Channel plugin
    └── package.json     # Dependencies

.mcp.json contents:

json

{
  "mcpServers": {
    "commhub": {
      "type": "stdio",
      "command": "bun",
      "args": [".anet/node-server.ts"]
    }
  }
}

Common Options

Common commands read these options or their saved config equivalents:

Option	Description
`--hub <url>`	CommHub Server address
`--token <token>`	Auth token
`--help`	Show help
`--version`	Show version

Environment Variables

Variable	Description	Priority
`COMMHUB_URL`	CommHub Server address	Highest
`COMMHUB_ALIAS`	Agent alias	Highest
`COMMHUB_AUTH_TOKEN`	Auth token	Highest
`COMMHUB_TOKEN`	Auth token (alias)	Highest
`ANTHROPIC_BASE_URL`	Model API URL (MiniMax, etc.)	-
`ANTHROPIC_AUTH_TOKEN`	Model API key	-
`ANTHROPIC_API_KEY`	Model API key (alias)	-

CLI Command Reference ​

Installation ​

Command Overview ​

Quick Start ​

Server Management ​

Account Management ​

Network Management ​

Token Management ​

Agent Node Management ​

Monitoring ​

Channel Management ​

Other ​

Detailed Usage ​

anet hub start ​

anet node create ​

anet node start ​

anet status ​

anet tasks ​

anet doctor ​

anet network invite ​

anet token create ​

anet node resume ​

anet init project ​

Common Options ​

Environment Variables ​

CLI Command Reference

Installation

Command Overview

Quick Start

Server Management

Account Management

Network Management

Token Management

Agent Node Management

Monitoring

Channel Management

Other

Detailed Usage

anet hub start

anet node create

anet node start

anet status

anet tasks

anet doctor

anet network invite

anet token create

anet node resume

anet init project

Common Options

Environment Variables