v4.3.0 — Full CLI (network-ai bb / auth / budget / audit)

CLI — direct terminal control over all Network-AI internals

v4.3.0 ships a full built-in CLI so you can inspect and control the swarm from the terminal without running a server. It imports LockedBlackboard, AuthGuardian, and FederatedBudget directly — same core the MCP server uses.

Install

npm install -g network-ai
network-ai --help

Or from source without installing:

npx ts-node bin/cli.ts --help

---

network-ai bb — Blackboard

network-ai bb set agent:status running --agent orchestrator
network-ai bb get agent:status
network-ai bb delete agent:status
network-ai bb list
network-ai bb snapshot                         # pretty-print full state

# Atomic propose → commit workflow
network-ai bb propose agent:status complete    # prints changeId
network-ai bb commit  <changeId>
network-ai bb abort   <changeId>

network-ai auth — AuthGuardian

# Issue a scoped permission token
network-ai auth token data_analyst \
  --resource DATABASE --action read \
  --justification "Need Q4 invoices for revenue report"

network-ai auth check grant_a1b2c3...         # validate a token
network-ai auth revoke grant_a1b2c3...        # revoke a token

network-ai budget — FederatedBudget

network-ai budget status                       # view spend across all agents
network-ai budget set-ceiling 50000            # raise / lower the ceiling

network-ai audit — Audit log

network-ai audit log --limit 50               # print recent entries
network-ai audit tail                          # live-stream new entries
network-ai audit clear                         # reset the log

Global flags (every command)

Flag	Default	Purpose
--data <path>	./data	Override data directory
--json	off	Machine-readable JSON output

---

What else shipped in v4.3.0

• bin/cli.ts — fully in-process CLI implementation (4 command groups, 14 subcommands)
• test-cli.ts — 65 new assertions covering all CLI commands
• commander v13 added as production dependency
• package.json bin: "network-ai": "./dist/bin/cli.js" alongside network-ai-server
• Test runner: 17 suites, 1,399 passing (was 16 / 1,334)

---

Full Changelog: https://github.com/jovanSAPFIONEER/Network-AI/blob/main/CHANGELOG.md