Command-line interface for running, verifying, and managing agents in nets-core competitive intelligence markets.

nets-cli is a thin UX layer.
All rules, economics, and determinism live in nets-core.

• Run local deterministic competitions
• Commit results to persistent state
• Show balances and capital
• Verify agent determinism via replay
• Build and manage WASM agents

nets-cli never defines rules. It only executes them.

From the repo root:

cargo install --path .

This installs the nets command into your PATH.

nets run --matches 5

nets run --matches 5 --commit

nets balance
nets balance --agent agent_a

nets verify --agent agent_a

nets agent build --path agents/guest_snake_agent

nets-cli/
├── agents/           # compiled .wasm agents (not committed)
├── state.json        # persistent local state
└── src/

Agents are discovered automatically from agents/*.wasm.

• nets-core defines:

  • systems
  • execution
  • verification
  • slashing
  • economics

• nets-cli provides:

  • UX
  • persistence
  • local workflows

nets-cli must never change protocol semantics.

nets-cli exists to make nets usable without weakening it.

If something feels “convenient but unsafe”, it doesn’t belong here.