CLI for GuideMode — capture and analyze your Claude Code sessions.
npx guidemodeThis walks you through everything:
- Browser login (GitHub OAuth)
- Installing Claude Code sync hooks
- Optionally installing the CLI globally
Once set up, your Claude Code sessions sync automatically to GuideMode.
npm install -g guidemodeFor teams using Claude Code, install the plugin for automatic session sync:
/plugin marketplace add guidemode/guidemode-marketplace
/plugin install guidemode-sync@guidemode-marketplace
The plugin uses the same CLI under the hood — npx guidemode handles everything.
guidemode # First run: guided setup. After: show help
guidemode setup # Re-run setup (login + hooks)
guidemode setup --force # Force re-authentication
guidemode login # Login only
guidemode logout # Clear credentials
guidemode whoami # Show current user
guidemode status # Health check
guidemode status --verbose # Detailed health check
guidemode sync # Sync current session (used by hooks)
guidemode logs # View sync logs
guidemode logs --errors # Show only errors
guidemode logs --follow # Tail logs in real-timeConfig lives at ~/.guidemode/config.json:
{
"apiKey": "gm_...",
"serverUrl": "https://app.guidemode.dev",
"tenantId": "your-tenant-id",
"tenantName": "Your Team",
"syncHooks": ["Stop", "PreCompact", "SessionEnd"]
}Omit syncHooks to enable all three (default).
git clone https://github.com/guidemode/guidemode.git
cd guidemode/packages/cli
pnpm install && pnpm buildSee CLAUDE.md for architecture and development details.
MIT