Files
claudemesh/CLAUDE.md
Alejandro Gutiérrez 45d85f5eaa
Some checks failed
CI / Lint (push) Has been cancelled
CI / Typecheck (push) Has been cancelled
CI / Broker tests (Postgres) (push) Has been cancelled
CI / Docker build (linux/amd64) (push) Has been cancelled
chore: wrap up the gap-closing session
- info/inbox commands → unified render.ts
- install route: drop in-memory counter, rely on PostHog + structured logs
- docs: roadmap, CLAUDE.md reflect alpha.31 state
- tests workflow now also builds + smoke-tests the CLI bundle
- homebrew tap bootstrap kit in packaging/homebrew-tap-bootstrap/
  (README + copy of the formula template for dropping into the tap repo)
- upstream Claude Code issue draft for rich <channel> UI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 08:53:59 +01:00

1.8 KiB

claudemesh

Peer mesh for Claude Code sessions. Broker + CLI + MCP server.

Structure

  • apps/broker/ — WebSocket broker (Bun + Drizzle + PostgreSQL), deployed at wss://ic.claudemesh.com/ws. Runs drizzle migrations on startup under pg_advisory_lock.
  • apps/cli/claudemesh-cli npm package (CLI + MCP server). Was apps/cli-v2/ until 2026-04-15; legacy v0 at branch legacy-cli-archive + tag cli-v0-legacy-final.
  • apps/web/ — Marketing site + dashboard at claudemesh.com
  • docs/ — Protocol spec, quickstart, FAQ, roadmap
  • packaging/ — Homebrew formula + winget manifest templates
  • .github/workflows/release-cli.yml — tag cli-v* → 5 platform binaries → GitHub Release with SHA256SUMS

Key docs

  • SPEC.md — What claudemesh is, protocol, crypto, wire format
  • docs/protocol.md — Wire protocol reference
  • docs/roadmap.md — Public roadmap (shipped + planned)
  • docs/vision-20260407.md — Internal feature brainstorm with 19 ideas across 3 tiers, effort estimates, and build order

Deploy

  • Broker: git push gitea-vps main triggers Coolify auto-deploy. Manual: curl -s -X GET "http://100.122.34.28:8000/api/v1/deploy?uuid=mcn8m74tbxfxbplmyb40b2ia" -H "Authorization: Bearer 3|K2vkSJzdUA69rj22CKZc5z0YB6pkY43GLEonti3UzcnqVJj6WhrqqYTAng6DzMUi". Pending migrations apply automatically on startup.
  • CLI:
    • npm: cd apps/cli && npm publish --tag alpha --access public --no-git-checks --ignore-scripts
    • Binaries: git tag cli-v<version> && git push github cli-v<version> — workflow builds 5 platforms.
  • Web: Vercel auto-deploy on push to GitHub

Dev

  • Monorepo: pnpm workspaces + Turborepo
  • Broker dev: cd apps/broker && bun --hot src/index.ts
  • CLI build: cd apps/cli && pnpm build (Bun bundler)
  • CLI link for local testing: cd apps/cli && npm link