From e286866c60ece006a0f78d353e3f6f51185fae2c Mon Sep 17 00:00:00 2001 From: arkon Date: Mon, 19 Jan 2026 03:43:59 +0100 Subject: [PATCH] docs: clarify web server startup commands in CLAUDE.md Make it explicit that `npm run dev` shows CLI help, not starts server. Document the correct command: `npx tsx src/index.ts web` Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 9bda16f4..126b2fb7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,12 +14,16 @@ Claudeman is a Claude Code session manager with a web interface and autonomous R ```bash npm run build # Compile TypeScript + copy static files to dist/web/ -npm run dev # Run with tsx (no build needed) npm run clean # Remove dist/ -npm link # Make 'claudeman' globally available -claudeman web # Start web interface on port 3000 -claudeman web -p 8080 # Custom port +# Start web server (pick one): +npx tsx src/index.ts web # Dev mode - no build needed (RECOMMENDED) +npx tsx src/index.ts web -p 8080 # Dev mode with custom port +node dist/index.js web # After npm run build +claudeman web # After npm link + +# NOTE: `npm run dev` runs the CLI (shows help), NOT the web server +# You must specify the `web` subcommand to start the server ``` ## Architecture