From 03661e1b687eae55a68bc8e504ef843159589fd5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alejandro=20Guti=C3=A9rrez?= <35082514+alezmad@users.noreply.github.com> Date: Tue, 7 Apr 2026 12:16:04 +0100 Subject: [PATCH] docs(cli): expand --help with all launch flags, groups hierarchy, env vars Co-Authored-By: Claude Sonnet 4.6 --- apps/cli/src/index.ts | 63 +++++++++++++++++++++++++++++-------------- 1 file changed, 43 insertions(+), 20 deletions(-) diff --git a/apps/cli/src/index.ts b/apps/cli/src/index.ts index c6d6721..facdc39 100644 --- a/apps/cli/src/index.ts +++ b/apps/cli/src/index.ts @@ -27,29 +27,52 @@ Usage: claudemesh [args] Commands: - install Register MCP + Stop/UserPromptSubmit status hooks - (add --no-hooks for bare MCP registration) - uninstall Remove MCP server + hooks - launch [opts] Launch Claude Code with real-time push messages - --name Display name for this session - --mesh Select mesh (picker if >1, omitted) - --join Join a mesh before launching - --quiet Skip the info banner - -- Pass remaining args to claude - join Join a mesh via https://claudemesh.com/join/... URL - list Show all joined meshes - leave Leave a joined mesh - status Health report: broker reachability per joined mesh - doctor Diagnostic checks (install, config, keypairs, PATH) - seed-test-mesh Dev-only: inject a mesh into config (skips invite flow) - mcp Start MCP server (stdio) — invoked by Claude Code + install Register MCP server + status hooks with Claude Code + --no-hooks Register MCP only, skip hooks + uninstall Remove MCP server and hooks + launch [opts] Launch Claude Code connected to a mesh + join Join a mesh via invite URL + list Show joined meshes and identities + leave Leave a mesh + status Check broker reachability for each joined mesh + doctor Diagnose install, config, keypairs, and PATH + mcp Start MCP server (stdio — Claude Code only) --help, -h Show this help - --version, -v Show the CLI version + --version, -v Show version + +launch options: + --name Display name for this session + --role Role tag (dev, lead, analyst — free-form) + --groups Groups to join: "g1:role,g2" (colon = role) + --mesh Select mesh by slug (interactive if omitted) + --join Join a mesh before launching + --message-mode push (default) | inbox | off + push — peer messages arrive in real time + inbox — held until you call check_messages + off — no messages; use tools only + --system-prompt Set Claude's system prompt for this session + -y, --yes Skip permission confirmation + --quiet Skip banner and all interactive prompts + -- Pass remaining args directly to claude + + Full non-interactive launch: + claudemesh launch \\ + --name Worker --mesh myteam --role analyst \\ + --groups "myteam/docs:member" \\ + --message-mode push \\ + --system-prompt "You are a documentation analyst..." \\ + -y --quiet + + Groups support hierarchy (slash-separated): + --groups "eng/frontend:lead,eng/reviewers" + @eng delivers to members of @eng, @eng/frontend, @eng/reviewers, etc. Environment: - CLAUDEMESH_BROKER_URL Override broker URL (default: wss://ic.claudemesh.com/ws) - CLAUDEMESH_CONFIG_DIR Override config directory (default: ~/.claudemesh/) - CLAUDEMESH_DEBUG=1 Verbose logging + CLAUDEMESH_BROKER_URL Override broker URL (default: wss://ic.claudemesh.com/ws) + CLAUDEMESH_CONFIG_DIR Override config directory (default: ~/.claudemesh/) + CLAUDEMESH_DISPLAY_NAME Override display name (set automatically by launch) + CLAUDEMESH_ROLE Override role tag (set automatically by launch) + CLAUDEMESH_DEBUG=1 Verbose logging `; const cmd = process.argv[2];