# Alfred Commander (Theia / code-server extension)

**Alfred IDE** = GoCodeMe **Theia** in the browser (`/ide/...`), **not** Cursor. Extensions are loaded from **`gocodeme/theia-fork/plugins/`** (see `gocodeme/docs/ALFRED_COMMANDER_THEIA.md`).

**New panel** — does **not** replace `gositeme.alfred-voice`; you can disable the old one when you’re happy.

## What’s included (full stack)

- **All agents & model routes** (same list as Alfred Voice)
- **Voice**: mic → Whisper STT → chat; **TTS** playback of replies
- **Hands-free**, **attachments** (images, PDF, text, ZIP), **payload meter**, **telemetry log**, **retry**
- **IDE shortcuts** as **explicit buttons** (Terminal, Save, Save all, Commands, Split, New file) — **chat text is never hijacked** by “save/search/find” phrases
- `run <cmd>` still sends **only** to the integrated terminal (not to AI)
- `insert` / `type` prefixes still insert at cursor

## Proven wiring (kept from working code)

- `POST /api/alfred-chat.php` with `ide_session_token`, IDE bearer headers, **Set-Cookie array** handling, CSRF retry
- `ide_client_id` / `ide_sig` HMAC when profile is available
- **Request id** on thinking rows for reply alignment

## Install (Alfred IDE / Theia — primary)

Canonical copy:

`~/.local/share/code-server/extensions/gositeme.alfred-commander-1.0.0/`

**Theia** (Alfred IDE) loads plugins from:

`gocodeme/theia-fork/plugins/gositeme.alfred-commander-1.0.0` → symlink to the canonical path above.

1. Confirm that symlink exists on the server.
2. **Restart your IDE session** (stop + launch Theia) so plugins reload.
3. **View → Open View…** → **Alfred Commander**.

Optional: **code-server**-only installs can use the same canonical path under `~/.local/share/code-server/extensions/`.

4. **Activity bar** — gold mic **Alfred Commander**; or **Command Palette** → **Alfred Commander: Open Panel**.
5. Optional: disable `alfred-voice` if you don’t want two Alfred panels.
6. To dock on the **right**: drag the view into the **secondary side bar** (View → Appearance → Secondary Side Bar).

## Commands & keys (no **View** menu required)

- **Ctrl+Shift+P** (or **F1**) → type **`Alfred Commander: Open Panel`** → Enter.  
  This works even when the top menu bar is hidden.
- **Ctrl+Shift+Alt+O** — **Open Panel** (after extension loads / VSIX updated).
- **Ctrl+Shift+Alt+A** — **Toggle mic**
- **Alfred Commander: Test API Connection** — from Command Palette

If the menu bar is missing: **Ctrl+Shift+P** → **Preferences: Open Settings** → search **`menu bar`** → set **Menu Bar Visibility** to **Visible** (or **Classic**). The extension also sets a default to show the menu when possible.

## Commands (palette)

- `Alfred Commander: Open Panel`
- `Alfred Commander: Toggle Mic`
- `Alfred Commander: Test API Connection`

## Token

Same as before: sign in at `/alfred-ide/`, `session.json` in `logs/alfred-ide/` or `~/.alfred-ide/`, or `ALFRED_IDE_TOKEN` env.