Clawd Agents

# this package — product hubs + GitHub sources (agents ↔ cli)
npx cheshire-terminal-agents connect
npx cheshire-terminal-agents catalog

# from this git checkout (no global install — `ct-agents` is not on PATH until npm i -g / npm link)
node bin/ct-agents.js connect
node bin/ct-agents.js acp
node bin/ct-agents.js a2a send --text 'who are you'
node bin/ct-agents.js serve

# official site CLI companion (cheshireterminal.ai/cli)
npx cheshire-terminal-cli connect
npx cheshire-terminal-cli eliza:status
npx cheshire-terminal-cli agents:list

# zero config — open the design TUI (fork templates → customize → save)
npx cheshire-terminal-agents

# or explicit
npx cheshire-terminal-agents design

# from this git checkout — bin is ./bin/ct-agents.js (zsh: command not found: ct-agents
# until you install globally or npm link)
node bin/ct-agents.js connect
node bin/ct-agents.js acp
node bin/ct-agents.js a2a send --text 'show CLAWD mint'
node bin/ct-agents.js serve
# same as: npx . connect   or   npm run acp

# put `ct-agents` on PATH
npm i -g cheshire-terminal-agents    # published package
# or, from this directory:
npm link                             # bins: cheshire-terminal-agents · ct-agents
ct-agents design
ct-agents catalog
ct-agents serve

# add to any project
npm i cheshire-terminal-agents

# interactive forge
ct-agents design
ct-agents forge          # alias

# list everything you can fork
ct-agents design --list

# non-interactive fork
ct-agents design --from defi-yield-farmer --id my-yield-bot --out ./agents/my-yield-bot.json

# blank scaffold
ct-agents design --blank --id research-bot --title "Research Bot" --out ./research-bot.json

# oneshot forge + choose Skill Hub skills (refs only — no bloat)
ct-agents design --from blank --id forge-bot \
  --skills metaplex-agent,cheshire-core \
  --out ./forge-bot.json

# same, and download ONLY those skills into ./.agents/skills
ct-agents design --from blank --id forge-bot \
  --skills metaplex-agent,trading \
  --install-skills \
  --out ./forge-bot.json

# birth any catalog agent: inherit skills[] + sparse-install them
ct-agents design --from clawd-imperial-perps --id my-imperial \
  --install-skills \
  --skills-target ./.agents/skills \
  --out ./my-imperial.json

# Skill Hub multi-select TUI / REPL (595 skills stay remote)
ct-agents skills              # interactive picker — toggle, then sparse-install
ct-agents skills pick         # same
ct-agents skills packs
ct-agents skills search vulcan
ct-agents skills install metaplex-agent          # sparse fetch of one skill
ct-agents skills attach ./forge-bot.json trading # add refs to existing agent

# Browser multi-select UI (after serve)
ct-agents serve
# open http://localhost:3000/skills-picker.html

# validate a definition
ct-agents design --validate ./agents/my-yield-bot.json

npx cheshire-terminal-agents design --list
npx cheshire-terminal-agents catalog
npx cheshire-terminal-agents connect
npx cheshire-terminal-agents skills packs
npx cheshire-terminal-agents dna list
npx cheshire-terminal-agents knowledge list
npx cheshire-terminal-agents storage status
npx cheshire-terminal-agents memory status
npx cheshire-terminal-agents acp
npx cheshire-terminal-agents a2a peers
npx cheshire-terminal-agents serve --port 8080

npx skills add tigrisdata/skills --skill '*' --agent cursor -y --copy

curl -fsS https://cheshireterminal.ai/api/agents/catalog | jq '.stats'
# local mirrors after: ct-agents serve --port 8080
curl -fsS http://localhost:8080/api/agents/catalog | jq '.stats'

# published package only
npm view cheshire-terminal-agents name version bin
# name = cheshire-terminal-agents
# version = 1.48.4
# bin.cheshire-terminal-agents = bin/ct-agents.js
# bin.ct-agents = bin/ct-agents.js

# 1. Install (global bin) — or skip this and use `node bin/ct-agents.js` from the checkout
npm i -g cheshire-terminal-agents

# 2. Catalog (139 agents · 3 one-shots · 7 featured)
ct-agents catalog

# 3. Skills — remote Skill Hub + local Robinhood suite (11 top-level)
ct-agents skills packs
ct-agents skills search vulcan

# 4. Design / forge an agent from a catalog template
ct-agents design --list
ct-agents design --from clawd-imperial-perps --id my-perps --out ./agents/my-perps.json

# 5. Agentic DNA from character seeds
ct-agents dna list
ct-agents dna generate --from clawd --out ./my-clawd-dna

# 6. Knowledge corpus (package + your uploads)
ct-agents knowledge list
ct-agents knowledge init --from clawd --out ./my-knowledge
ct-agents knowledge upload ./notes.md --out ./my-knowledge

# 7. Membrain memory (default source for every catalog agent)
ct-agents memory status
ct-agents memory ingest --agent elizero --summary "session note"
ct-agents memory retrieve --agent elizero --query "what did we decide"

# 8. Schema + local API (ACP/A2A routes included)
ct-agents schema
ct-agents serve --port 8080

# 9. Product hubs + ACP/A2A (from checkout: node bin/ct-agents.js …)
ct-agents connect
ct-agents acp
ct-agents a2a send --text 'who are you'

npm run build      # rebuild agents-catalog.json + validate
npm run validate   # schema / catalog checks
npm test           # catalog + smoke-readme + dna + knowledge + eliza/zk paths + OSS map
npm run catalog    # print compact stats JSON
npm run test:dna
npm run test:membrain
npm run test:knowledge
npm run test:eliza-zk
npm run verify:oss
node bin/ct-agents.js catalog
node bin/ct-agents.js dna list
node bin/ct-agents.js knowledge list
node bin/ct-agents.js skills packs --json
node bin/ct-agents.js --help

node scripts/smoke-readme-npm.cjs