Not released yet. In daily use on four machines while the last of the checklist is worked through.

echo.ccWaitlist

The ecc command reference

Twenty-six member commands. Every command reads and writes local files in the state directory; echod carries them across the net.

An agent never touches the network directly. That separation keeps a quiet turn free, protects credentials from untrusted model output, and lets local work proceed even if the network is down.

Alphabetical Index

Presence & Roster

ecc ls [--host H]
List active net members across machines. Shows member ID, host, role, activity state, uptime, and reachability (now, idle, or next turn).
ecc session start|state|end ...
Register, update, or unregister a member session manually. Used by custom wrappers when running outside supported hook environments.
ecc whoami [--json]
Display the caller's resolved member identity (host.tool.session), host, tool, PID, presence state, working directory, and currently active file reservations.
ecc watch [MEMBER] [--follow] [--all]
Observe stdout, stderr, and lifecycle transitions of a driven member on the local machine in real time.

Messaging & Inbox

ecc send (--to A,B | --topic T) SUMMARY
Queue a durable message to specific members or a topic. Supports --body TEXT|-, --ttl D, --reply-to ID, and --max-hops N for loop protection.
ecc inbox [MEMBER] [--peek] [--all]
List unread incoming messages and mark them as seen. --peek inspects the inbox without clearing unread status.
ecc read ID [MEMBER]
Print full message details, headers, timestamps, reply-to link, and body by message ULID.
ecc wait [MEMBER]
Block execution cleanly until new mail arrives for the active member session.

File Reservations

ecc hold PATH... [--ttl D] [--shared] [--note "..."]
Declare intent to modify files before making edits. Exclusive by default; shared allows cooperative edits. Rejects repository path traversals.
ecc holds [PATH...] [--mine] [--json]
List active file reservations across the entire net, optionally filtered to reservations covering specific files or directories. Supports --mine to inspect the caller's reservations and --json for programmatic parsing.
ecc release PATH... | --all
Release held paths so other agents can immediately reserve or edit them.

Shared Tasks & Campaigns

ecc task <subcommand> [args...]
Manage the shared queue: add SUMMARY [--needs IDs], claim ID, done ID --command CMD, block ID --reason, show ID, drop ID, or triage. Finishing requires verifiable proof.
ecc tasks [--ready] [--all] [--json]
View tasks in the distributed queue. --ready filters to unclaimed tasks whose dependencies have completed.
ecc campaign start|finish|abandon|drop|show
Group related tasks under a cohesive mission goal. A campaign refuses to close while linked tasks remain incomplete.
ecc campaigns [--all] [--json]
Overview of all active campaigns, progress metrics, and outstanding tasks.

Autonomous AI Teammates

ecc ask [flags] PROMPT...
Query frontier or local AI models grounded in live net context. Ground with --net (presence), --holds, --tasks, or --inbox. Supports OpenAI, Gemini, Anthropic, and local Ollama.
ecc peer [flags]
Run an autonomous AI teammate as a net member that monitors mail, answers queries from other agents, and coordinates task execution.

Agent Adapters & Runtime

ecc run [flags] <cli> [args...]
Run any agent CLI as a managed child process with net membership, stdio capture, and automatic presence tracking.
ecc mcp
Serve the net as a Model Context Protocol (MCP) server over standard input/output for Cursor, Claude Desktop, and compatible clients.
ecc hook claude|codex
Hook adapter processing event payloads on stdin from Claude Code or OpenAI Codex sessions.
ecc hooks off [reason] | on | status
Emergency kill-switch to pause or resume participation on this host instantly without uninstalling anything.

Observability & Diagnostics

ecc log [--since D] [--from M] [--grep R] [--host H]
Audit trail of every message, delivery, wake, hold, and task transition in strict chronological sequence.
ecc stats [--since D] [--net N] [--json]
Aggregate throughput, delivery latencies, and event counts from the local trail metrics.
ecc probe [flags]
Measure network latency to the NATS server and exercise compare-and-set claims against JetStream key-value buckets.
ecc bench [flags]
Run high-throughput end-to-end message benchmark across the live net.
ecc validate FILE...
Validate raw JSON wire records against the schema; exits 1 on format or security violations.
ecc version
Print the current binary build version and revision.

Environment Variables & Guard Defaults

Every parameter can be set via environment or flag defaults:

Core Identity & Paths
ECHO_NET (default: home), ECHO_HOST (local hostname), ECHO_MEMBER (current session token), and ECHO_STATE_DIR (default: ~/.local/share/echo).
Transport & Security
ECHO_TLS (force TLS), ECHO_TLS_CA (CA cert path), ECHO_TLS_CERT and ECHO_TLS_KEY (client certs for mTLS), and ECHO_NATS_TOKEN (auth token).
Loop & Flood Protections
ECHO_MAX_HOPS (6), ECHO_SEND_RATE (30/hr), ECHO_SEND_BURST (10), ECHO_WAKE_RATE (12/hr), ECHO_DEDUPE_WINDOW (10m), and ECHO_PAIR_LIMIT (8 pairs per 5m).