alfred-commander/README.md

# Alfred Commander

**3,551-line VS Code extension — AI chat, voice, stats, walkthrough — the brain of Alfred IDE.**

Alfred Commander is a single-file VS Code/code-server extension that provides multi-provider AI chat, speech-to-text/text-to-speech, workspace intelligence, and an interactive walkthrough. It is the primary user interface for Alfred IDE.

## Architecture

One extension, one `extension.js` — 3,551 lines of production code. No framework, no bundler, no node_modules. Pure VS Code API.

### What It Does

| Feature | How it works |
|---------|-------------|
| **AI Chat** | Multi-provider (Anthropic Claude, OpenAI GPT, Groq, local Ollama) via streaming API |
| **Voice** | Browser SpeechRecognition for STT, Kokoro TTS engine for speech output |
| **Attachments** | Drag-and-drop files/images into chat, base64 encoding for vision models |
| **Model Picker** | Runtime model switching across all providers |
| **Stats Panel** | Account usage, token counts, billing period, plan badge |
| **Walkthrough** | 6-page interactive onboarding (sovereignty, models, voice, shortcuts, stats) |
| **Sidebar** | Custom webview with full HTML/CSS/JS UI rendered in VS Code panel |
| **MCP Tools** | 500+ tools via gocodeme-mcp service integration |

### Commands

| Command | Action |
|---------|--------|
| `alfred-commander.open` | Open the Alfred chat panel |
| `alfred-commander.toggle` | Toggle panel visibility |
| `alfred-commander.showStats` | Account & usage statistics |
| `alfred-commander.welcome` | Open walkthrough |
| `alfred-commander.workspaceStatus` | Workspace health check |

## File Structure

```
alfred-commander/
├── extension.js              # 3,551 lines — entire extension
├── package.json              # Extension manifest, commands, keybindings
├── extensions.json           # Extension dependency declarations
├── media/
│   ├── alfred-icon.svg       # Panel icon
│   └── walkthrough/
│       ├── meet-alfred.md    # Introduction walkthrough
│       ├── sovereign.md      # Sovereignty & privacy walkthrough
│       ├── models.md         # AI model configuration
│       ├── voice.md          # Voice assistant setup
│       ├── shortcuts.md      # Keyboard shortcuts reference
│       └── stats.md          # Usage statistics guide
```

## Key Design Decisions

- **Single file**: No build step, no transpilation, no bundler. `extension.js` is the extension.
- **Webview UI**: Full HTML/CSS/JS UI rendered inside VS Code's webview API — not a tree view or quick pick.
- **Multi-provider**: Provider abstraction supports Anthropic, OpenAI, Groq, and Ollama with a single chat interface.
- **Offline voice**: TTS via local Kokoro engine (no cloud API calls for speech).
- **Zero telemetry**: No analytics, no tracking, no phone-home. Conversations stay on the server.

## Runs On

- **Alfred IDE** (cloud): code-server 4.x on Linux — primary target
- **Alfred IDE** (desktop): Windows portable build
- **VS Code**: Compatible with stock VS Code (some features require Alfred infrastructure)

## License

AGPL-3.0