Skip to content

Commit 1e44e65

Browse files
committed
docs: remove references to cut VSCode extension UI
1 parent 634ac18 commit 1e44e65

File tree

6 files changed

+30
-94
lines changed

6 files changed

+30
-94
lines changed

md/SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@
5050
- [Testing](./design/vscode-extension/testing.md)
5151
- [Testing Implementation](./design/vscode-extension/testing-implementation.md)
5252
- [Packaging](./design/vscode-extension/packaging.md)
53-
- [Mod UI](./design/vscode-extension/mods.md)
53+
- [Mods UI](./design/vscode-extension/mods.md)
5454
- [Language Model Provider](./design/vscode-extension/lm-provider.md)
5555
- [Language Model Tool Bridging](./design/vscode-extension/lm-tool-bridging.md)
5656
- [Implementation Status](./design/vscode-extension/implementation-status.md)
-451 KB
Binary file not shown.

md/design/vscode-extension/implementation-status.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -91,17 +91,15 @@ These allow protocol extensions beyond the ACP specification. Not currently need
9191
- [ ] Workspace-specific state persistence
9292
- [ ] Tab history and conversation export
9393

94-
## Agent Extensions
94+
## Agent Mods
9595

96-
Agent extensions are proxy components that enrich the agent's capabilities. See [Agent Extensions](./extensions.md) for details.
96+
Agent mods are proxy components that enrich the agent's capabilities. See [Agent Mods](./mods.md) for details.
9797

9898
- [x] CLI support (`--proxy` argument for `symposium-acp-agent`)
99-
- [x] VS Code setting (`symposium.extensions` array)
100-
- [x] Settings UI with enable/disable checkboxes
101-
- [x] Drag-to-reorder in Settings UI
102-
- [x] Delete and add extensions back
103-
- [ ] Registry extensions (install from agent registry with `type = 'extension'`)
104-
- [ ] Per-extension configuration (e.g., which Ferris tools to enable)
99+
- [x] Config agent with interactive `/symposium:config` command
100+
- [x] Per-workspace mod configuration
101+
- [ ] Registry mods (install from agent registry with `type = 'mod'`)
102+
- [ ] Per-mod configuration (e.g., which Ferris tools to enable)
105103

106104
## Language Model Provider (Experimental)
107105

md/design/vscode-extension/mods.md

Lines changed: 9 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,63 +1,16 @@
1-
# Mod UI (VSCode)
1+
# Mods UI (VSCode)
22

3-
This chapter covers VSCode-specific UI for managing mods. For general mod concepts, see [Agent Mods](../mods.md).
3+
This chapter covers how mods work in the VSCode environment. For general mod concepts, see [Agent Mods](../mods.md).
44

5-
## Configuration Storage
5+
## Configuration
66

7-
Mods are configured via the `symposium.mods` VS Code setting:
7+
Mods are configured through the Symposium config agent, not through VSCode settings. The VSCode extension spawns `symposium-acp-agent run`, which handles all configuration.
88

9-
```json
10-
"symposium.mods": [
11-
{ "id": "sparkle", "_enabled": true, "_source": "built-in" },
12-
{ "id": "ferris", "_enabled": true, "_source": "built-in" },
13-
{ "id": "cargo", "_enabled": true, "_source": "built-in" }
14-
]
15-
```
16-
17-
Custom mods include their distribution:
18-
19-
```json
20-
{
21-
"id": "my-mod",
22-
"_enabled": true,
23-
"_source": "custom",
24-
"name": "My Mod",
25-
"distribution": {
26-
"npx": { "package": "@myorg/my-mod" }
27-
}
28-
}
29-
```
30-
31-
**Default behavior** - when no setting exists, all built-in mods are enabled. If the user returns to the default configuration, the key is removed from settings.json entirely.
32-
33-
## Settings UI
34-
35-
The Settings panel includes a Mods section where users can:
36-
37-
- **Enable/disable** mods via checkbox
38-
- **Reorder** mods by dragging the handle
39-
- **Delete** mods from the list
40-
- **Add** mods via the "+ Add mod" link, which opens a QuickPick dialog
41-
42-
### Add Mod Dialog
43-
44-
The QuickPick dialog shows three sections:
45-
46-
1. **Built-in** - sparkle, ferris, cargo (greyed out if already added)
47-
2. **From Registry** - mods from the shared registry with `type: "mod"`
48-
3. **Add Custom Mod**:
49-
- From executable on your system (local command/path)
50-
- From npx package
51-
- From pipx package
52-
- From cargo crate
53-
- From URL to mod.json (GitHub URLs auto-converted to raw)
9+
See [Run Mode](../run-mode.md) for details on:
10+
- Configuration file format (`~/.symposium/config/`)
11+
- Interactive configuration via `/symposium:config` command
12+
- First-time setup flow
5413

5514
## Spawn Integration
5615

57-
When spawning an agent, the extension builds `--proxy` arguments from enabled mods:
58-
59-
```bash
60-
symposium-acp-agent run-with --proxy sparkle --proxy ferris --proxy cargo --agent '...'
61-
```
62-
63-
Only enabled mods are passed, in their configured order.
16+
The VSCode extension spawns the agent using `symposium-acp-agent run`. The config agent loads mod configuration from disk and builds the proxy chain automatically.

md/install-vscode.md

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,20 +11,9 @@ Install the Symposium extension from:
1111

1212
## Step 2: Activate the panel and start chatting
1313

14-
<div class="panel-guide">
15-
<img src="./artwork/screenshots/screenshot-vscode-panel.jpg" alt="Symposium panel in VSCode"/>
16-
<div class="panel-legend">
17-
18-
1. **Activity bar icon** — Click to open the Symposium panel
19-
2. **New tab** — Start a new conversation with the current settings
20-
3. **Settings** — Expand to configure agent and extensions
21-
4. **Agent selector** — Choose which agent to use (Claude Code, Gemini CLI, etc.)
22-
5. **Extensions** — Enable MCP servers that add capabilities to your agent
23-
6. **Add extension** — Add custom extensions
24-
7. **Edit all settings** — Access full settings
25-
26-
</div>
27-
</div>
14+
Click the Symposium icon in the activity bar to open the panel, then click **New tab** to start a conversation.
15+
16+
On first run, Symposium will guide you through selecting an agent. After that, you can change your agent or mods at any time by typing `/symposium:config` in the chat.
2817

2918
## Custom Agents
3019

md/using/symposium.md

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Using Symposium
22

3-
Symposium focuses on creating the best environment for Rust coding through **Agent Extensions** - MCP servers that add specialized tools and context to your agent.
3+
Symposium focuses on creating the best environment for Rust coding through **Agent Mods** - MCP servers that add specialized tools and context to your agent.
44

55
Symposium is built on the Agent Client Protocol (ACP), which means the core functionality is portable across editors and environments. VSCode is the showcase environment with experimental GUI support, but the basic functionality can be configured in any ACP-supporting editor.
66

@@ -19,26 +19,22 @@ Symposium checks for updates and installs new versions automatically as they bec
1919

2020
For adding custom agents not in the registry, see [VSCode Installation - Custom Agents](../install-vscode.md#custom-agents).
2121

22-
## Managing Extensions
22+
## Managing Mods
2323

24-
Extensions add capabilities to your agent. Open the **Settings** panel to manage them.
24+
Mods add capabilities to your agent. To configure mods, type `/symposium:config` in the chat.
2525

26-
In the Extensions section you can:
27-
- **Enable/disable** extensions via the checkbox
28-
- **Reorder** extensions by dragging the handle
29-
- **Add** extensions via the "+ Add extension" link
30-
- **Delete** extensions from the list
26+
The configuration menu lets you:
27+
- **Toggle** mods on/off by typing their number
28+
- **Reorder** mods with `move X to Y`
29+
- **Save** changes with `SAVE` or discard with `CANCEL`
3130

32-
**Order matters** - extensions are applied in the order listed. The first extension is closest to the editor, and the last is closest to the agent.
31+
**Order matters** - mods are applied in the order listed. The first mod is closest to the editor, and the last is closest to the agent.
3332

34-
When adding extensions, you can choose from:
35-
- **Built-in** extensions (Sparkle, Ferris, Cargo)
36-
- **Registry** extensions from the shared catalog
37-
- **Custom** extensions via executable, npx, pipx, cargo, or URL
33+
On first run, Symposium recommends mods based on your workspace (e.g., Cargo mod for Rust projects). You can adjust these recommendations in the config menu.
3834

39-
## Builtin Extensions
35+
## Builtin Mods
4036

41-
Symposium ships with three builtin extensions:
37+
Symposium ships with three builtin mods:
4238

4339
- **[Sparkle](./sparkle.md)** - AI collaboration framework that learns your working patterns
4440
- **[Ferris](./ferris.md)** - Rust crate source inspection

0 commit comments

Comments
 (0)