alezmad/claudemesh
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
397ddb4c45f6134f7450afc348cae32e3e7433f0
claudemesh/CLAUDE.md
Alejandro Gutiérrez 397ddb4c45
Some checks failed
CI / Lint (push) Has been cancelled
Details
CI / Typecheck (push) Has been cancelled
Details
CI / Broker tests (Postgres) (push) Has been cancelled
Details
CI / Docker build (linux/amd64) (push) Has been cancelled
Details
docs: mark v0.4.0 phase 2 shipped + record web deploy trick 
roadmap entry for the me-topics + dashboard-topics ship.

claude.md gets the long-overdue note that apps/web is on coolify
on the ovh vps, not vercel — it does not auto-deploy on push to
gitea-vps the way the broker does, and that mismatch cost a
session of debugging. records the manual deploy command so the
next time we ship a web change we don't rediscover the issue.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 01:36:05 +01:00

2.2 KiB
Raw Blame History

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: Coolify on the OVH VPS (claudemesh.com resolves to 135.125.191.245, NOT Vercel — the apps/web/Dockerfile is what Coolify builds). Push to gitea-vps does NOT auto-deploy the web app the way it does the broker. Trigger manually: curl -s -X GET "http://100.122.34.28:8000/api/v1/deploy?uuid=p68x1e3k4xmrjmblca5ybe09" -H "Authorization: Bearer 3|K2vkSJzdUA69rj22CKZc5z0YB6pkY43GLEonti3UzcnqVJj6WhrqqYTAng6DzMUi"

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
Reference in New Issue View Git Blame Copy Permalink