docs: add Using Symposium section and improve installation guides #97
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add a new Extensions section to the VS Code settings panel that allows users to enable/disable, reorder, and manage Symposium proxy extensions (Sparkle, Ferris, Cargo). Changes: - CLI: Replace --sparkle/--ferris/--cargo flags with --proxy <name> - Rust: Add Symposium::from_proxy_names() to configure chain from names - VS Code: Add symposium.extensions setting with default built-ins - VS Code: Add Extensions UI with checkboxes, drag-to-reorder, delete/add - Docs: Add extensions.md chapter and update implementation status The extension order in the UI matches the proxy chain order passed to symposium-acp-agent. Disabled extensions are skipped, deleted extensions can be re-added via the '+ Add extension' menu. Co-authored-by: Claude <claude@anthropic.com>
New tabs now respect the current extension settings. The agent process key includes enabled extensions, so changing extensions will spawn a new agent process with the updated configuration. Co-authored-by: Claude <claude@anthropic.com>
Documents the 'configuration not affecting new tabs' bug pattern that occurs when settings affect process spawning but aren't included in AgentConfiguration.key(). Co-authored-by: Claude <claude@anthropic.com>
- Create md/design/common-issues.md for project-wide bug patterns - Add reference link from VS Code architecture doc - Add instruction in AGENTS.md to check common issues before coding - Update SUMMARY.md Co-authored-by: Claude <claude@anthropic.com>
Co-authored-by: Claude <claude@anthropic.com>
- New extension settings format with _enabled, _source fields - Extensions can come from: built-in, registry, or custom sources - Custom extensions support: executable, npx, pipx, or URL to extension.json - GitHub URLs automatically rewritten to raw.githubusercontent.com - Registry format updated to include extensions array alongside agents - Added extensionRegistry.ts with types, built-ins, and dialog logic - Simplified settings UI to use QuickPick instead of dropdown menu Co-authored-by: Claude <claude@anthropic.com>
- Handle old 'enabled' field by migrating to '_enabled' - Default to enabled=true when neither field present - Auto-detect built-in source for extensions without _source Co-authored-by: Claude <claude@anthropic.com>
Co-authored-by: Claude <claude@anthropic.com>
- Document new settings format with _enabled, _source - Add Extension Sources section - Document QuickPick dialog and custom extension options - Add registry format section - Update architecture diagram - Remove completed items from Future Work Co-authored-by: Claude <claude@anthropic.com>
- Add two-step install flow: install extension, then activate panel - Add annotated screenshot showing panel components - Add panel-guide CSS for side-by-side screenshot/legend layout - Fix marketplace link (symposium-dev.symposium) Co-authored-by: Claude <claude@anthropic.com>
- Add md/using/ directory with symposium overview, sparkle, ferris, cargo pages - Document agent selection, extension management, and custom agents - Reorganize SUMMARY.md into Using Symposium and Contributing sections - Add Custom Agents section to VSCode install page Co-authored-by: Claude <claude@anthropic.com>
- Change hero subtitle to Poppins bold + underline (simpler, matches site) - Remove unused font imports (Dancing Script, Caesar Dressing, etc.) - Fix Get Started link to point to install.md - Remove pre-alpha warning banner Co-authored-by: Claude <claude@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds user-facing documentation for using Symposium and improves the installation guides.
Documentation changes
New "Using Symposium" section with:
VSCode install page improvements:
Intro page updates:
SUMMARY.md reorganization:
Also includes
Earlier commits for agent extensions UI and related fixes.