{"_id":"@aster110/cc-mesh","name":"@aster110/cc-mesh","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aster110/cc-mesh","version":"0.1.0","description":"Spawn and orchestrate full-power Claude Code / Codex instances via a local relay — terminal injection, peer messaging, shared KV blackboard","license":"MIT","bin":{"mesh":"packages/cli/mesh.sh"},"dependencies":{"better-sqlite3":"^11.0.0"},"engines":{"node":">=18.0.0"},"os":["darwin","linux"],"repository":{"type":"git","url":"git+https://github.com/Aster110/cc-mesh.git"},"keywords":["claude-code","codex","agent","mesh","multi-agent","tmux"],"publishConfig":{"registry":"https://registry.npmjs.org","access":"public"},"_id":"@aster110/cc-mesh@0.1.0","gitHead":"723959fc3c4a8740cc9a3ceadef7b5baf206b338","bugs":{"url":"https://github.com/Aster110/cc-mesh/issues"},"homepage":"https://github.com/Aster110/cc-mesh#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-pIhfaunpct1ErExvwvgYSiTlxw+X6NhBn8uXYHJJTaplIiey4XQ0k5yi6U3GTvW84Ki98K8zuTpmPde95xm2Kg==","shasum":"99d2805e25c75bfe8a096647c4cbd6589e4371bd","tarball":"https://registry.npmjs.org/@aster110/cc-mesh/-/cc-mesh-0.1.0.tgz","fileCount":8,"unpackedSize":1819011,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCVHpZ+n4Q3SpWfPPyu3gdu/sT9F1FdUmcm2So7HUkEoAIgWS1qLc4g5Epth18ePIUpFkgqH0X0f96AR9XgC3qlAq8="}]},"_npmUser":{"name":"aster110","email":"1105950073@qq.com"},"directories":{},"maintainers":[{"name":"aster110","email":"1105950073@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cc-mesh_0.1.0_1781169154670_0.28804449024868717"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-11T09:12:34.480Z","0.1.0":"2026-06-11T09:12:34.893Z","modified":"2026-06-11T09:12:35.117Z"},"maintainers":[{"name":"aster110","email":"1105950073@qq.com"}],"description":"Spawn and orchestrate full-power Claude Code / Codex instances via a local relay — terminal injection, peer messaging, shared KV blackboard","homepage":"https://github.com/Aster110/cc-mesh#readme","keywords":["claude-code","codex","agent","mesh","multi-agent","tmux"],"repository":{"type":"git","url":"git+https://github.com/Aster110/cc-mesh.git"},"bugs":{"url":"https://github.com/Aster110/cc-mesh/issues"},"license":"MIT","readme":"# cc-mesh\n\nSpawn and orchestrate full-power Claude Code / Codex instances from your terminal. A local relay (port 19800) handles peer messaging, terminal injection (AppleScript / tmux), node registry, and a shared KV blackboard.\n\n## Install\n\n```bash\nnpm install -g @aster110/cc-mesh\n```\n\nRequires Node.js >= 18, `tmux`, and a C++ toolchain for `better-sqlite3` (Xcode CLT on macOS). On macOS, spawning into iTerm tabs requires iTerm2.\n\n## Quick Start\n\n```bash\n# 1. Install the Claude Code skill (optional but recommended)\nmesh skill install\n\n# 2. Start the local relay\nmesh relay start\nmesh relay status\n\n# 3. Create an agent profile (machine-local config)\nmkdir -p ~/.ccmesh/agents\ncat > ~/.ccmesh/agents/tcc.json <<'EOF'\n{\n  \"name\": \"tcc\",\n  \"launcher\": \"cc\",\n  \"cwd\": \"/path/to/your/workspace\",\n  \"terminal\": \"tmux\",\n  \"autoInit\": true\n}\nEOF\n\n# 4. Register yourself, then spawn a worker\nmesh init main \"lead\"        # run inside an interactive iTerm/tmux session\nexport MESH_NODE=<printed nodeId>\nmesh spawn --agent tcc\n```\n\n`mesh spawn` only performs the naming + handshake. After the worker reports `[bootstrap][ready]`, dispatch work explicitly:\n\n```bash\nmesh send <worker-nodeId> \"your task...\"\n```\n\n## Commands\n\n```\nmesh send / inbox / status / broadcast / context / devices\nmesh init / register / unregister / heartbeat\nmesh spawn --agent <profile> [--on <device>] [--window] [--dir <path>] [--lead <nodeId>]\nmesh kv set / get / list / del\nmesh relay start / stop / restart / status / logs\nmesh skill install [--force]\n```\n\n## Multi-machine Hub (optional)\n\nBy default cc-mesh runs in local-only mode and connects to nothing. To join multiple machines, deploy your own hub (WS routing center) and point the relay at it:\n\n```bash\necho 'ws://<your-hub-host>:19900' > ~/.ccmesh/hub-url\nmesh relay restart\n```\n\nOr set `MESH_HUB_URL` (empty string = explicitly disabled). Cross-region nodes can route the uplink through a local HTTP proxy via `MESH_HTTPS_PROXY`.\n\n## Data\n\nAll runtime state lives in `~/.ccmesh/`: `db/mesh.db` (SQLite audit + KV), `context/`, `agents/`, `relay.pid`, `hub-url`.\n","readmeFilename":"README.md","_rev":"1-0f70b8de65e8e5efe4f1fe9f30641978"}