61 lines
2.9 KiB
Markdown
61 lines
2.9 KiB
Markdown
|
# 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.
|