` | Add context title to review | ### Secrets | Command | Description | |---------|-------------| | `wispy secrets list` | List stored secret keys | | `wispy secrets set <key> <value>` | Store an encrypted secret | | `wispy secrets get <key>` | Retrieve a secret (masked) | | `wispy secrets get <key> --reveal` | Show the actual value | | `wispy secrets delete <key>` | Delete a secret | ### Browser | Command | Description | |---------|-------------| | `wispy browser` | Show browser bridge status | | `wispy browser status` | Alias for `wispy browser` | | `wispy browser tabs [browser]` | List open tabs | | `wispy browser attach [browser]` | Attach to a running browser | | `wispy browser navigate <url>` | Navigate to URL | | `wispy browser screenshot [file]` | Take a screenshot | | `wispy browser doctor` | Full browser bridge diagnostics | ### Text-to-Speech | Command | Description | |---------|-------------| | `wispy tts "<text>"` | Speak text (OpenAI TTS or macOS `say`) | | `wispy tts "<text>" --voice <name>` | Use a specific voice | | `wispy tts "<text>" --provider openai\|macos` | Force a TTS provider | | `wispy tts "<text>" --play` | Play audio immediately (macOS) | ### Trust & Security | Command | Description | |---------|-------------| | `wispy trust` | Interactive trust settings (level, audit log) | | `wispy trust level` | Show/set security level | | `wispy trust log` | View approval audit log | ### Continuity | Command | Description | |---------|-------------| | `wispy where` | Show current mode, workstream, provider | | `wispy handoff cloud` | Push local context to cloud | | `wispy handoff local` | Pull remote context to local | ### Skills | Command | Description | |---------|-------------| | `wispy skill list` | List learned skills | | `wispy skill run <name>` | Run a skill | | `wispy teach <name>` | Create a skill from conversation | | `wispy improve <name>` | Improve an existing skill | ### Server & TUI | Command | Description | |---------|-------------| | `wispy server start` | Start HTTP/WebSocket server | | `wispy server stop` | Stop server | | `wispy server status` | Show server status | | `wispy tui` | Launch full-screen terminal UI | | `wispy overview` | Director view of all workstreams | ### Cost | Command | Description | |---------|-------------| | `wispy cost` | Show API spending report (session + all-time) | | `wispy budget` | Alias for `wispy cost` | --- ## Global Flags | Flag | Description | |------|-------------| | `-w, --workstream <name>` | Set active workstream | | `-p, --profile <name>` | Use a named config profile | | `-i, --image <path>` | Attach image (can repeat for multiple) | | `--session <id>` | Resume an existing session | | `--name <name>` | Give this session a display name | | `--model <name>` | Override AI model for this run | | `--provider <name>` | Override AI provider for this run | | `--personality <name>` | Set personality (`pragmatic`, `concise`, `explanatory`, `friendly`, `strict`) | | `--agent <name>` | Use a named agent (`reviewer`, `planner`, `explorer`, or custom) | | `--effort <level>` | Effort level: `low`, `medium`, `high`, `max` (default: `medium`) | | `--system-prompt <text>` | Replace default system prompt entirely | | `--append-system-prompt <text>` | Append text to the default system prompt | | `--max-budget-usd <amount>` | Session budget cap (e.g. `5.00`) | | `--allowedTools <patterns>` | Only allow specified tools (e.g. `"read_file Bash(git:*)"`) | | `--disallowedTools <patterns>` | Block specified tools (e.g. `"write_file delete_file"`) | | `--json` | Output JSONL events (for `exec` command, CI use) | | `-h, --help` | Show help | | `-v, --version` | Show version | --- ## Feature Highlights ### Smart Routing Automatically routes tasks to the most suitable model based on task type. Complex reasoning goes to capable models; quick lookups use fast models. Enable: `wispy features enable smart_routing` ### Task Decomposition Splits complex tasks into parallel subtasks and executes them concurrently, then merges results. Dramatically faster for multi-file operations. Enable: `wispy features enable task_decomposition` ### Context Compaction Automatically summarizes older conversation history when approaching token limits, keeping context fresh without losing important information. Enable: `wispy features enable context_compaction` ### Loop Detection Detects when the AI is stuck in a repetitive tool-call loop and breaks out gracefully with a summary. Enable: `wispy features enable loop_detection` ### Browser Integration Control a real browser via `local-browser-bridge`. Navigate pages, take screenshots, list tabs, extract content. Enable: `wispy features enable browser_integration` Requires: `npx local-browser-bridge serve` ### Auto Memory Automatically extracts facts, decisions, and preferences from conversations and saves them to the memory store for future sessions. Enable: `wispy features enable auto_memory` ### Multi-Agent Orchestration Spawn concurrent sub-agents for parallel execution. Each agent runs in an isolated worker thread with its own tool access. Enable: `wispy features enable multi_agent` ### TTS Automatic text-to-speech output. Supports OpenAI TTS (multiple voices) and macOS `say` as fallback. Enable: `wispy features enable tts` --- ## Providers wispy-cli supports 27 AI providers out of the box: | Provider | Key | Notes | |----------|-----|-------| | Google AI | `google` | Gemini 2.0/2.5 series | | Anthropic | `anthropic` | Claude 3.x/4.x series | | OpenAI | `openai` | GPT-4o, o1, o3 series | | xAI | `xai` | Grok models | | Mistral | `mistral` | Mistral + Codestral | | Together AI | `together` | Open-source model hosting | | NVIDIA | `nvidia` | NVIDIA NIM | | Groq | `groq` | Ultra-fast inference | | DeepSeek | `deepseek` | DeepSeek-V3/R1 | | Chutes | `chutes` | Chutes API | | OpenRouter | `openrouter` | 200+ models via one key | | Vercel AI SDK | `vercelai` | Vercel AI gateway | | Kimi | `kimi` | Moonshot AI | | MiniMax | `minimax` | MiniMax models | | Venice | `venice` | Privacy-focused | | Hugging Face | `huggingface` | HF Inference API | | Cloudflare | `cloudflare` | Workers AI | | VolcEngine | `volcengine` | ByteDance cloud |

# wispy-cli **AI workspace assistant — chat, automate, and orchestrate from the terminal.** wispy-cli puts a trustworthy AI co-pilot in your shell. It handles multi-turn conversations, tool execution with approval controls, session persistence, sub-agent orchestration, code review, browser automation, and more — all from a single `wispy` command. --- ## Table of Contents - [Quick Start](#quick-start) - [Commands](#commands) - [Global Flags](#global-flags) - [Feature Highlights](#feature-highlights) - [Providers](#providers) - [Configuration](#configuration) - [Agent System](#agent-system) - [Trust & Security](#trust--security) - [Memory System](#memory-system) - [Sub-Agent Orchestration](#sub-agent-orchestration) - [Browser Integration](#browser-integration) - [Text-to-Speech](#text-to-speech) - [Code Review](#code-review) - [JSONL Event Stream](#jsonl-event-stream) - [Sessions](#sessions) - [Architecture](#architecture) - [Development](#development) - [Credits](#credits) --- ## Quick Start ```bash # Install npm install -g wispy-cli # First-time setup (choose provider, set API key) wispy setup # Start chatting wispy ``` One-shot (non-interactive): ```bash wispy "summarize the last 10 commits" wispy exec "list all TODO comments in src/" --json # JSONL output ``` --- ## Commands ### Core | Command | Description | |---------|-------------| | `wispy` | Start interactive REPL | | `wispy ` | One-shot chat | | `wispy exec ` | Non-interactive one-shot (CI/pipeline friendly) | | `wispy setup` | Run first-time setup wizard | ### Configuration | Command | Description | |---------|-------------| | `wispy config show` | Print full config as JSON | | `wispy config path` | Print path to config file | | `wispy config get ` | Get a config value | | `wispy config set ` | Set a config value | | `wispy config delete ` | Delete a config key | | `wispy config reset` | Reset config to defaults (with confirmation) | | `wispy config edit` | Open config in `$EDITOR` | ### System | Command | Description | |---------|-------------| | `wispy doctor` | Check system health (provider, API key, dirs) | | `wispy model` | Interactive model/provider picker | | `wispy model list` | List all available models by provider | | `wispy model ` | Set model directly (e.g. `wispy model gpt-4o`) | | `wispy where` | Show current mode, provider, workstream, and memory stats | ### Feature Flags | Command | Description | |---------|-------------| | `wispy features list` | List all feature flags with status | | `wispy features enable ` | Enable a feature flag | | `wispy features disable ` | Disable a feature flag | ### Agents | Command | Description | |---------|-------------| | `wispy agents` | List available agents (built-in + custom) | | `wispy agents list` | Alias for `wispy agents` | ### Sessions | Command | Description | |---------|-------------| | `wispy sessions` | List sessions (interactive picker) | | `wispy sessions --all` | List sessions from all workstreams | | `wispy sessions --no-interactive` | Non-interactive listing | | `wispy resume [session-id]` | Resume a previous session | | `wispy resume --last` | Resume the most recent session | | `wispy fork [session-id]` | Fork a session (branch from history) | | `wispy fork --last` | Fork the most recent session | ### Code Review | Command | Description | |---------|-------------| | `wispy review` | Review uncommitted changes (staged + unstaged) | | `wispy review --base ` | Review changes against a base branch | | `wispy review --commit ` | Review a specific commit | | `wispy review --json` | Output review as structured JSON | | `wispy review --title ` | Add context title to review | ### Secrets | Command | Description | |---------|-------------| | `wispy secrets list` | List stored secret keys | | `wispy secrets set <key> <value>` | Store an encrypted secret | | `wispy secrets get <key>` | Retrieve a secret (masked) | | `wispy secrets get <key> --reveal` | Show the actual value | | `wispy secrets delete <key>` | Delete a secret | ### Browser | Command | Description | |---------|-------------| | `wispy browser` | Show browser bridge status | | `wispy browser status` | Alias for `wispy browser` | | `wispy browser tabs [browser]` | List open tabs | | `wispy browser attach [browser]` | Attach to a running browser | | `wispy browser navigate <url>` | Navigate to URL | | `wispy browser screenshot [file]` | Take a screenshot | | `wispy browser doctor` | Full browser bridge diagnostics | ### Text-to-Speech | Command | Description | |---------|-------------| | `wispy tts "<text>"` | Speak text (OpenAI TTS or macOS `say`) | | `wispy tts "<text>" --voice <name>` | Use a specific voice | | `wispy tts "<text>" --provider openai\|macos` | Force a TTS provider | | `wispy tts "<text>" --play` | Play audio immediately (macOS) | ### Trust & Security | Command | Description | |---------|-------------| | `wispy trust` | Interactive trust settings (level, audit log) | | `wispy trust level` | Show/set security level | | `wispy trust log` | View approval audit log | ### Continuity | Command | Description | |---------|-------------| | `wispy where` | Show current mode, workstream, provider | | `wispy handoff cloud` | Push local context to cloud | | `wispy handoff local` | Pull remote context to local | ### Skills | Command | Description | |---------|-------------| | `wispy skill list` | List learned skills | | `wispy skill run <name>` | Run a skill | | `wispy teach <name>` | Create a skill from conversation | | `wispy improve <name>` | Improve an existing skill | ### Server & TUI | Command | Description | |---------|-------------| | `wispy server start` | Start HTTP/WebSocket server | | `wispy server stop` | Stop server | | `wispy server status` | Show server status | | `wispy tui` | Launch full-screen terminal UI | | `wispy overview` | Director view of all workstreams | ### Cost | Command | Description | |---------|-------------| | `wispy cost` | Show API spending report (session + all-time) | | `wispy budget` | Alias for `wispy cost` | --- ## Global Flags | Flag | Description | |------|-------------| | `-w, --workstream <name>` | Set active workstream | | `-p, --profile <name>` | Use a named config profile | | `-i, --image <path>` | Attach image (can repeat for multiple) | | `--session <id>` | Resume an existing session | | `--name <name>` | Give this session a display name | | `--model <name>` | Override AI model for this run | | `--provider <name>` | Override AI provider for this run | | `--personality <name>` | Set personality (`pragmatic`, `concise`, `explanatory`, `friendly`, `strict`) | | `--agent <name>` | Use a named agent (`reviewer`, `planner`, `explorer`, or custom) | | `--effort <level>` | Effort level: `low`, `medium`, `high`, `max` (default: `medium`) | | `--system-prompt <text>` | Replace default system prompt entirely | | `--append-system-prompt <text>` | Append text to the default system prompt | | `--max-budget-usd <amount>` | Session budget cap (e.g. `5.00`) | | `--allowedTools <patterns>` | Only allow specified tools (e.g. `"read_file Bash(git:*)"`) | | `--disallowedTools <patterns>` | Block specified tools (e.g. `"write_file delete_file"`) | | `--json` | Output JSONL events (for `exec` command, CI use) | | `-h, --help` | Show help | | `-v, --version` | Show version | --- ## Feature Highlights ### Smart Routing Automatically routes tasks to the most suitable model based on task type. Complex reasoning goes to capable models; quick lookups use fast models. Enable: `wispy features enable smart_routing` ### Task Decomposition Splits complex tasks into parallel subtasks and executes them concurrently, then merges results. Dramatically faster for multi-file operations. Enable: `wispy features enable task_decomposition` ### Context Compaction Automatically summarizes older conversation history when approaching token limits, keeping context fresh without losing important information. Enable: `wispy features enable context_compaction` ### Loop Detection Detects when the AI is stuck in a repetitive tool-call loop and breaks out gracefully with a summary. Enable: `wispy features enable loop_detection` ### Browser Integration Control a real browser via `local-browser-bridge`. Navigate pages, take screenshots, list tabs, extract content. Enable: `wispy features enable browser_integration` Requires: `npx local-browser-bridge serve` ### Auto Memory Automatically extracts facts, decisions, and preferences from conversations and saves them to the memory store for future sessions. Enable: `wispy features enable auto_memory` ### Multi-Agent Orchestration Spawn concurrent sub-agents for parallel execution. Each agent runs in an isolated worker thread with its own tool access. Enable: `wispy features enable multi_agent` ### TTS Automatic text-to-speech output. Supports OpenAI TTS (multiple voices) and macOS `say` as fallback. Enable: `wispy features enable tts` --- ## Providers wispy-cli supports 27 AI providers out of the box: | Provider | Key | Notes | |----------|-----|-------| | Google AI | `google` | Gemini 2.0/2.5 series | | Anthropic | `anthropic` | Claude 3.x/4.x series | | OpenAI | `openai` | GPT-4o, o1, o3 series | | xAI | `xai` | Grok models | | Mistral | `mistral` | Mistral + Codestral | | Together AI | `together` | Open-source model hosting | | NVIDIA | `nvidia` | NVIDIA NIM | | Groq | `groq` | Ultra-fast inference | | DeepSeek | `deepseek` | DeepSeek-V3/R1 | | Chutes | `chutes` | Chutes API | | OpenRouter | `openrouter` | 200+ models via one key | | Vercel AI SDK | `vercelai` | Vercel AI gateway | | Kimi | `kimi` | Moonshot AI | | MiniMax | `minimax` | MiniMax models | | Venice | `venice` | Privacy-focused | | Hugging Face | `huggingface` | HF Inference API | | Cloudflare | `cloudflare` | Workers AI | | VolcEngine | `volcengine` | ByteDance cloud | | B</article></body></html>