edf9d0be6f
33 markdown files organized for GitBook import with SUMMARY.md navigation. Covers installation, core concepts, auto mode, configuration, all providers, cost management, skills, parallel orchestration, remote questions, teams, headless CI, and full command reference. User-facing only — no internal/dev content. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.9 KiB
Installation
Install GSD
npm install -g gsd-pi
Requires Node.js 22.0.0 or later (24 LTS recommended) and Git.
{% hint style="info" %}
command not found: gsd? Your shell may not have npm's global bin directory in $PATH. Run npm prefix -g to find it, then add $(npm prefix -g)/bin to your PATH. See Troubleshooting for details.
{% endhint %}
GSD checks for updates once every 24 hours. When a new version is available, you'll see a prompt at startup with the option to update immediately or skip. You can also update from within a session with /gsd update.
Set Up Your LLM Provider
Launch GSD for the first time:
gsd
The setup wizard walks you through:
- LLM Provider — choose from 20+ providers (Anthropic, OpenAI, Google, OpenRouter, GitHub Copilot, Amazon Bedrock, Azure, and more). OAuth flows handle Claude Max and Copilot subscriptions automatically; otherwise paste an API key.
- Tool API Keys (optional) — Brave Search, Context7, Jina, Slack, Discord. Press Enter to skip any.
Re-run the wizard anytime with:
gsd config
For detailed provider setup, see Provider Setup.
Set Up API Keys for Tools
If you use a non-Anthropic model, you may need a search API key for web search. Run /gsd config inside any GSD session to set keys globally — they're saved to ~/.gsd/agent/auth.json and apply to all projects.
| Tool | Purpose | Get a Key |
|---|---|---|
| Tavily Search | Web search for non-Anthropic models | tavily.com |
| Brave Search | Web search for non-Anthropic models | brave.com |
| Context7 Docs | Library documentation lookup | context7.com |
Anthropic models have built-in web search and don't need these keys.
VS Code Extension
GSD is also available as a VS Code extension. Install from the marketplace (publisher: FluxLabs) or search for "GSD" in VS Code extensions.
The extension provides:
@gsdchat participant — talk to the agent in VS Code Chat- Sidebar dashboard — connection status, model info, token usage, quick actions
- Full command palette — start/stop agent, switch models, export sessions
The CLI (gsd-pi) must be installed first — the extension connects to it via RPC.
Web Interface
GSD also has a browser-based interface:
gsd --web
This starts a local web server with a visual dashboard, real-time progress, and multi-project support. See Web Interface for details.
Alternative Binary Name
If the gsd command conflicts with another tool (e.g., the oh-my-zsh git plugin aliases gsd to git svn dcommit), use the alternative:
gsd-cli
Both gsd and gsd-cli point to the same binary. To remove the conflict permanently, add this to your ~/.zshrc:
unalias gsd 2>/dev/null