@guidemode/cli

Command-line interface for GuideMode.

A simple CLI for authenticating with GuideMode and managing sessions from your terminal.

Installation

npm install -g @guidemode/cli

Usage

Authentication

# Login to GuideMode
guidemode login

# Check who you're logged in as
guidemode whoami

# Logout
guidemode logout

That's it! The CLI shares authentication with the desktop app, so you only need to login once.

What It Does

• Login: Opens browser for GitHub OAuth authentication
• Session Info: Check your authentication status
• Logout: Clear stored credentials

Perfect for CI/CD pipelines, scripts, or terminal-focused workflows.

Configuration

Shares config with desktop app: ~/.guidemode/config.json

{
  "apiKey": "your-api-key",
  "serverUrl": "https://app.guidemode.dev",
  "username": "your-username"
}

For Developers

Build from Source

git clone https://github.com/guidemode/cli.git
cd cli
pnpm install
pnpm build

See CLAUDE.md for:

• Development setup
• Architecture details
• Adding new commands

Tech Stack

• Commander.js for CLI parsing
• Dual build (ESM + CommonJS)
• TypeScript with full type safety

Related Packages

• @guidemode/desktop - Desktop app
• @guidemode/types - Shared types

License

MIT License - see LICENSE

Support

• 💬 Discussions - Ask questions, share ideas
• 🐛 Issues - Report bugs, request features
• 📧 Email: [email protected]