indigo-cli 0.1.0

package/README.md

@@ -0,0 +1,1030 @@
+# Indigo CLI
+
+Terminal-based access to Indigo for power users. Authenticate, browse signals, manage meetings, and chat with Indigo AI without launching the Electron app.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+  - [auth](#auth---authentication-commands)
+  - [account](#account---account-management)
+  - [signals](#signals---signal-management)
+  - [chat](#chat---chat-with-indigo-ai)
+  - [setup](#setup---configuration-and-setup)
+  - [meetings](#meetings---meeting-management)
+- [Exit Codes](#exit-codes)
+- [Configuration](#configuration)
+- [Output Formats](#output-formats)
+- [Troubleshooting](#troubleshooting)
+- [Common Workflows](#common-workflows)
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g @anthropic/indigo-cli
+```
+
+### Standalone binaries (no Node.js required)
+
+Download the binary for your platform from [GitHub Releases](https://github.com/anthropics/indigo-nx/releases):
+
+| Platform | Download |
+|----------|----------|
+| macOS (Apple Silicon) | `indigo-macos-arm64` |
+| macOS (Intel) | `indigo-macos-x64` |
+| Linux (x64) | `indigo-linux-x64` |
+| Windows (x64) | `indigo-win-x64.exe` |
+
+#### macOS / Linux
+
+```bash
+# Download the binary (example for macOS ARM64)
+curl -L -o indigo https://github.com/anthropics/indigo-nx/releases/latest/download/indigo-macos-arm64
+
+# Make it executable
+chmod +x indigo
+
+# Move to a directory in your PATH
+sudo mv indigo /usr/local/bin/
+
+# Verify installation
+indigo --version
+```
+
+On macOS, you may need to allow the app in System Preferences > Security & Privacy if you see a security warning.
+
+#### Windows
+
+1. Download `indigo-win-x64.exe` from the releases page
+2. Rename to `indigo.exe` (optional)
+3. Move to a directory in your PATH, or run directly from the download location
+
+```powershell
+# Verify installation
+.\indigo.exe --version
+```
+
+### From source
+
+```bash
+git clone https://github.com/anthropics/indigo-nx.git
+cd indigo-nx
+pnpm install
+nx run cli:build
+# Binary available at dist/apps/cli/main.js
+```
+
+## Quick Start
+
+```bash
+# 1. Authenticate (opens browser)
+indigo auth login
+
+# 2. Run interactive setup wizard (optional)
+indigo setup
+
+# 3. List your signals
+indigo signals list
+
+# 4. Start a chat session
+indigo chat start
+```
+
+## Commands
+
+### auth - Authentication Commands
+
+Manage authentication with your Indigo account.
+
+#### auth login
+
+Authenticate with your Indigo account via browser-based OAuth.
+
+**Syntax:**
+```bash
+indigo auth login [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--force` | Force CLI-specific login even if Electron app credentials exist |
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# Standard login (opens browser)
+indigo auth login
+
+# Force new credentials even if using desktop app
+indigo auth login --force
+
+# Get login status as JSON
+indigo auth login --json
+```
+
+**Notes:**
+- If you're already logged into the Indigo desktop app, the CLI will automatically use those credentials
+- Use `--force` to create CLI-specific credentials separate from the desktop app
+
+---
+
+#### auth logout
+
+Log out and clear stored credentials.
+
+**Syntax:**
+```bash
+indigo auth logout [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# Log out
+indigo auth logout
+
+# Log out with JSON output
+indigo auth logout --json
+```
+
+---
+
+#### auth status
+
+Display current authentication status including user info and token expiry.
+
+**Syntax:**
+```bash
+indigo auth status [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# Check authentication status
+indigo auth status
+
+# Get detailed status as JSON
+indigo auth status --json
+```
+
+**Output includes:**
+- Login status (logged in / not logged in)
+- User email and ID
+- Token expiry time
+- Credential source (CLI or Electron desktop app)
+- Storage method (system keychain or encrypted file)
+
+---
+
+### account - Account Management
+
+Manage your Indigo account.
+
+#### account create
+
+Create a new Indigo account via browser-based signup.
+
+**Syntax:**
+```bash
+indigo account create [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-e, --email <email>` | Email address (development/test environments only) |
+| `-p, --password <password>` | Password (development/test environments only) |
+
+**Examples:**
+```bash
+# Create account via browser (standard flow)
+indigo account create
+
+# Create account in dev/test environment
+indigo account create --email user@example.com --password mypassword123
+```
+
+**Notes:**
+- The `--email` and `--password` flags are only available in development/test environments
+- In production, account creation always uses the browser-based OAuth flow
+- Password must be at least 8 characters
+
+---
+
+#### account info
+
+Display information about your current account.
+
+**Syntax:**
+```bash
+indigo account info [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# View account info
+indigo account info
+
+# Get account info as JSON
+indigo account info --json
+```
+
+**Output includes:**
+- Email address
+- Display name
+- User ID
+- Company (if associated)
+- Credential source
+
+---
+
+### signals - Signal Management
+
+Browse and search your Indigo signals. Signals are insights extracted from your meetings, emails, and communications.
+
+#### signals list
+
+List your recent signals.
+
+**Syntax:**
+```bash
+indigo signals list [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-n, --limit <number>` | Number of results to show (default: 20) |
+| `-t, --type <type>` | Filter by signal type |
+
+**Valid signal types:**
+- `decision` - Decisions made in meetings or communications
+- `action` - Action items identified
+- `accomplishment` - Accomplishments or completed items
+- `key_fact` - Important facts or information
+
+**Examples:**
+```bash
+# List recent signals
+indigo signals list
+
+# List 50 signals
+indigo signals list --limit 50
+
+# List only decisions
+indigo signals list --type decision
+
+# List action items as JSON
+indigo signals list --type action --json
+```
+
+---
+
+#### signals search
+
+Search your signals by content.
+
+**Syntax:**
+```bash
+indigo signals search <query> [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `query` | Search term (required) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-n, --limit <number>` | Number of results to show (default: 20) |
+| `-t, --type <type>` | Filter by signal type |
+
+**Examples:**
+```bash
+# Search for budget-related signals
+indigo signals search "budget"
+
+# Search for project decisions
+indigo signals search "project update" --type decision
+
+# Search with custom limit
+indigo signals search "quarterly" --limit 10 --json
+```
+
+---
+
+#### signals view
+
+View the full details of a specific signal.
+
+**Syntax:**
+```bash
+indigo signals view <id> [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `id` | Signal ID (24-character hexadecimal string) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# View a signal by ID
+indigo signals view 507f1f77bcf86cd799439011
+
+# View signal as JSON
+indigo signals view 507f1f77bcf86cd799439011 --json
+```
+
+**Output includes:**
+- Signal type and title
+- Source (meeting, email, etc.)
+- Creation and update timestamps
+- Related people, teams, projects
+- Full content and citations
+
+---
+
+### chat - Chat with Indigo AI
+
+Start and manage interactive chat sessions with Indigo AI.
+
+#### chat start
+
+Start a new interactive chat session.
+
+**Syntax:**
+```bash
+indigo chat start [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output session info as JSON (non-interactive) |
+| `--no-stream` | Disable streaming, wait for complete responses |
+
+**Examples:**
+```bash
+# Start interactive chat
+indigo chat start
+
+# Start chat without streaming
+indigo chat start --no-stream
+
+# Get session info as JSON (for scripting)
+indigo chat start --json
+```
+
+**Interactive commands:**
+- Type your message and press Enter to send
+- Type `exit` or `quit` to end the session
+- Press `Ctrl+C` to cancel
+
+---
+
+#### chat continue
+
+Resume an existing chat session.
+
+**Syntax:**
+```bash
+indigo chat continue <session-id> [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `session-id` | Chat session ID (24-character hexadecimal string) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output session info as JSON (non-interactive) |
+| `--no-stream` | Disable streaming, wait for complete responses |
+
+**Examples:**
+```bash
+# Continue a previous session
+indigo chat continue 507f1f77bcf86cd799439011
+
+# Continue without streaming
+indigo chat continue 507f1f77bcf86cd799439011 --no-stream
+```
+
+---
+
+#### chat list
+
+List your recent chat sessions.
+
+**Syntax:**
+```bash
+indigo chat list [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-n, --limit <number>` | Number of sessions to show (default: 10) |
+
+**Examples:**
+```bash
+# List recent chat sessions
+indigo chat list
+
+# List more sessions
+indigo chat list --limit 20
+
+# Get sessions as JSON
+indigo chat list --json
+```
+
+---
+
+### setup - Configuration and Setup
+
+Configure Indigo CLI settings including API keys and calendar integration.
+
+#### setup wizard
+
+Run the interactive setup wizard to configure all settings.
+
+**Syntax:**
+```bash
+indigo setup [options]
+indigo setup wizard [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output current status as JSON (non-interactive) |
+
+**Examples:**
+```bash
+# Run setup wizard
+indigo setup
+
+# Check what needs to be configured
+indigo setup --json
+```
+
+**Setup wizard covers:**
+1. Authentication verification
+2. API keys configuration (BYOK - Bring Your Own Key)
+3. Google Calendar connection
+
+---
+
+#### setup status
+
+Show current configuration status.
+
+**Syntax:**
+```bash
+indigo setup status [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# Check setup status
+indigo setup status
+
+# Get status as JSON
+indigo setup status --json
+```
+
+**Output includes:**
+- Authentication status
+- Configured API key providers
+- Calendar connection status
+
+---
+
+#### setup calendar
+
+Connect and manage Google Calendar integration.
+
+**Syntax:**
+```bash
+indigo setup calendar [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `--status` | Show current calendar connection status |
+| `--select` | Select which calendars to sync |
+| `--disconnect` | Disconnect Google Calendar |
+
+**Examples:**
+```bash
+# Connect Google Calendar (opens browser)
+indigo setup calendar
+
+# Check calendar connection status
+indigo setup calendar --status
+
+# Select calendars to sync
+indigo setup calendar --select
+
+# Disconnect calendar
+indigo setup calendar --disconnect
+```
+
+---
+
+#### setup keys
+
+Configure API keys for AI model providers (BYOK - Bring Your Own Key).
+
+**Syntax:**
+```bash
+indigo setup keys [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `--list` | List configured API key providers |
+| `-p, --provider <provider>` | Configure a specific provider |
+| `--remove <provider>` | Remove API key for a provider |
+
+**Supported providers:**
+| Provider | Description |
+|----------|-------------|
+| `openai` | GPT-4, GPT-4o and other OpenAI models |
+| `anthropic` | Claude models (Claude 3, Claude 3.5, etc.) |
+| `google` | Gemini models |
+| `xai` | Grok models |
+
+**Examples:**
+```bash
+# Interactive setup for all providers
+indigo setup keys
+
+# List configured providers
+indigo setup keys --list
+
+# Configure OpenAI API key
+indigo setup keys --provider openai
+
+# Remove an API key
+indigo setup keys --remove anthropic
+
+# Get configuration as JSON
+indigo setup keys --list --json
+```
+
+---
+
+### meetings - Meeting Management
+
+View and search your calendar meetings. Requires Google Calendar to be connected.
+
+#### meetings list
+
+List your meetings.
+
+**Syntax:**
+```bash
+indigo meetings list [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-n, --limit <number>` | Number of results to show (default: 20) |
+| `--upcoming` | Show upcoming meetings (default) |
+| `--past` | Show past meetings |
+
+**Examples:**
+```bash
+# List upcoming meetings
+indigo meetings list
+
+# List past meetings
+indigo meetings list --past
+
+# List more meetings
+indigo meetings list --limit 50 --json
+```
+
+---
+
+#### meetings view
+
+View detailed information about a specific meeting.
+
+**Syntax:**
+```bash
+indigo meetings view <id> [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `id` | Meeting ID (24-character hexadecimal string) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+
+**Examples:**
+```bash
+# View meeting details
+indigo meetings view 507f1f77bcf86cd799439011
+
+# Get meeting as JSON
+indigo meetings view 507f1f77bcf86cd799439011 --json
+```
+
+**Output includes:**
+- Meeting title and status
+- Date, time, and duration
+- Meeting URL
+- Participants and their response status
+- Description and summary (if available)
+
+---
+
+#### meetings search
+
+Search meetings by title, description, or attendee.
+
+**Syntax:**
+```bash
+indigo meetings search <query> [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `query` | Search term (required) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON for scripting |
+| `-n, --limit <number>` | Number of results to show (default: 20) |
+| `--upcoming` | Search only upcoming meetings |
+| `--past` | Search only past meetings |
+
+**Examples:**
+```bash
+# Search all meetings
+indigo meetings search "standup"
+
+# Search upcoming meetings only
+indigo meetings search "review" --upcoming
+
+# Search past meetings
+indigo meetings search "quarterly" --past --limit 10
+```
+
+---
+
+## Exit Codes
+
+The CLI uses standardized exit codes for scripting and automation:
+
+| Code | Name | Description |
+|------|------|-------------|
+| 0 | Success | Command completed successfully |
+| 1 | General Error | An unexpected error occurred |
+| 2 | Authentication Required | User is not authenticated; run `indigo auth login` |
+| 3 | Not Found | Requested resource (signal, meeting, chat) was not found |
+| 4 | Configuration Error | Missing or invalid configuration (e.g., calendar not connected) |
+| 5 | Validation Error | Invalid command arguments or options |
+
+**Example usage in scripts:**
+```bash
+indigo signals list --json > signals.json
+if [ $? -eq 2 ]; then
+  echo "Please log in first"
+  indigo auth login
+fi
+```
+
+---
+
+## Configuration
+
+### Environment Variables
+
+For chat functionality, the following environment variables must be set:
+
+| Variable | Description |
+|----------|-------------|
+| `LANGGRAPH_API_URL` | URL of your LangGraph instance |
+| `LANGSMITH_API_KEY` | Your LangSmith API key |
+| `LANGGRAPH_ASSISTANT_ID` | Your LangGraph assistant ID |
+
+**Example:**
+```bash
+export LANGGRAPH_API_URL="https://your-langgraph-instance.com"
+export LANGSMITH_API_KEY="your-api-key"
+export LANGGRAPH_ASSISTANT_ID="your-assistant-id"
+```
+
+### Credential Storage
+
+The CLI stores credentials securely using one of two methods:
+
+1. **System keychain** (preferred) - Uses the native OS keychain:
+   - macOS: Keychain Access
+   - Windows: Credential Manager
+   - Linux: Secret Service API (GNOME Keyring, KWallet)
+
+2. **Encrypted config file** (fallback) - Used when system keychain is unavailable
+
+**Config file location:**
+- macOS/Linux: `~/.config/indigo-cli/`
+- Windows: `%APPDATA%/indigo-cli/`
+
+### Shared Credentials with Desktop App
+
+If you have the Indigo desktop app installed and logged in, the CLI will automatically detect and use those credentials. To use separate CLI-specific credentials, run:
+
+```bash
+indigo auth login --force
+```
+
+---
+
+## Output Formats
+
+All data commands support JSON output for scripting and automation.
+
+### Human-readable output (default)
+
+```bash
+indigo signals list
+```
+
+Output is formatted for terminal display with tables, colors, and word wrapping.
+
+### JSON output
+
+```bash
+indigo signals list --json
+```
+
+JSON output follows a consistent schema:
+
+**Success response:**
+```json
+{
+  "success": true,
+  "data": { ... }
+}
+```
+
+**Error response:**
+```json
+{
+  "success": false,
+  "error": {
+    "message": "Error description",
+    "code": "ERROR_CODE"
+  }
+}
+```
+
+### Piping to jq
+
+```bash
+# Get the first signal's title
+indigo signals list --json | jq '.[0].data.title'
+
+# Filter signals by type
+indigo signals list --json | jq '[.[] | select(.insightType == "decision")]'
+```
+
+---
+
+## Troubleshooting
+
+### "Authentication required" error
+
+**Problem:** Commands fail with exit code 2 and "Not authenticated" message.
+
+**Solution:**
+```bash
+# Log in to your account
+indigo auth login
+
+# Check authentication status
+indigo auth status
+```
+
+### Credentials not persisting
+
+**Problem:** You need to log in every time you use the CLI.
+
+**Solution:**
+1. Check if keytar (system keychain integration) installed correctly
+2. If keytar fails, credentials fall back to an encrypted config file
+3. Verify the config directory exists and is writable:
+   ```bash
+   ls -la ~/.config/indigo-cli/
+   ```
+
+### Chat not working
+
+**Problem:** Chat commands fail with configuration errors.
+
+**Solution:**
+1. Verify LangGraph environment variables are set:
+   ```bash
+   echo $LANGGRAPH_API_URL
+   echo $LANGSMITH_API_KEY
+   echo $LANGGRAPH_ASSISTANT_ID
+   ```
+2. Ensure all three variables are configured correctly
+
+### Calendar commands failing
+
+**Problem:** Meeting commands fail with "Calendar not connected" error.
+
+**Solution:**
+```bash
+# Check calendar connection status
+indigo setup calendar --status
+
+# Connect your calendar
+indigo setup calendar
+```
+
+### "Invalid signal type" error
+
+**Problem:** Signal filtering fails with validation error.
+
+**Solution:** Use one of the valid signal types:
+- `decision`
+- `action`
+- `accomplishment`
+- `key_fact`
+
+```bash
+indigo signals list --type decision
+```
+
+### Invalid ID format
+
+**Problem:** Commands fail with "Invalid ID format" error.
+
+**Solution:** IDs must be 24-character hexadecimal strings (MongoDB ObjectIds).
+```bash
+# Correct format
+indigo signals view 507f1f77bcf86cd799439011
+
+# Get IDs from list commands
+indigo signals list --json | jq '.[0]._id'
+```
+
+### Browser not opening during login
+
+**Problem:** Browser doesn't open automatically for OAuth.
+
+**Solution:**
+1. Copy the URL displayed in the terminal
+2. Paste it manually into your browser
+3. Complete the login flow
+4. Return to the terminal
+
+---
+
+## Common Workflows
+
+### First-time setup
+
+```bash
+# 1. Create account or log in
+indigo auth login
+# or
+indigo account create
+
+# 2. Run the setup wizard
+indigo setup
+
+# 3. Connect your calendar
+indigo setup calendar
+
+# 4. Configure API keys (optional)
+indigo setup keys
+
+# 5. Verify everything is configured
+indigo setup status
+```
+
+### Daily workflow
+
+```bash
+# Check upcoming meetings
+indigo meetings list
+
+# Review recent signals
+indigo signals list --limit 10
+
+# Start a chat to discuss your day
+indigo chat start
+```
+
+### Searching for information
+
+```bash
+# Find all decisions about a project
+indigo signals search "Project Alpha" --type decision
+
+# Find meetings with a specific person
+indigo meetings search "john@example.com"
+
+# Find action items from last month
+indigo signals list --type action --limit 50
+```
+
+### Scripting and automation
+
+```bash
+#!/bin/bash
+
+# Export signals to file
+indigo signals list --json > signals.json
+
+# Check if authenticated
+if ! indigo auth status --json | jq -e '.data.isAuthenticated' > /dev/null; then
+  echo "Please log in first"
+  exit 1
+fi
+
+# Get upcoming meetings
+indigo meetings list --json | jq '[.[] | {title: .meeting_title, time: .start_time}]'
+```
+
+### Continuing a previous chat
+
+```bash
+# List recent chat sessions
+indigo chat list
+
+# Continue a specific session
+indigo chat continue 507f1f77bcf86cd799439011
+```
+
+---
+
+## Requirements
+
+**npm installation:**
+- Node.js 18.0.0 or higher
+
+**Standalone binaries:**
+- No runtime dependencies (Node.js is bundled)
+
+**Optional (all installation methods):**
+- System keychain access for secure credential storage
+
+---
+
+## License
+
+MIT