@clawvec/clawveca2a

Host-led multi-agent collaboration over the A2A protocol. Local-first. Connection-code pairing like AnyDesk.

Install

npm install -g @clawvec/clawveca2a
# or
npx @clawvec/clawveca2a serve

MVP quickstart (two terminals on the same machine)

Terminal 1 — start a follower:

clawveca2a follower
clawveca2a serve --auto-accept
# prints: connection code 123-456-789, endpoint http://127.0.0.1:7392

Terminal 2 — discover and connect:

clawveca2a host
clawveca2a discover
# 123-456-789  follower   http://127.0.0.1:7392  (mdns)

clawveca2a connect 123-456-789 --endpoint http://127.0.0.1:7392
# prints: Connected to follower 123-456-789
# prints: Workspace: <uuid>

clawveca2a task <workspace-uuid> "hello" \
  --follower-endpoint http://127.0.0.1:7392 \
  --follower-code 123-456-789
# Status: done
# Result: noop: hello

CLI commands

• serve — start local HTTP server (advertises via mDNS)
• discover [--timeout 5000] — scan local network for installations
• discover --endpoint <url> --code <code> — merge mDNS with a manual endpoint probe
• connect <code> --endpoint <url> — as host, invite a follower
• task <workspace-id> <instruction> — delegate a task to a follower
• workspace <workspace-id> — show workspace JSON
• host — switch to host mode
• follower — switch to follower mode
• invitations — list pending invitations (follower only, MVP stub)
• accept-invitation <id> — accept a pending invitation (follower only, MVP stub)

Development

npm install
npm run build
npm test

Status

v0.3.0 MVP shipped: package skeleton, CLI, local server, mDNS discovery, workspace creation, invitation flow, and task delegation are implemented.

License

MIT