ace-pm 35dc87ef53 chore: sync workspace state after rebrand

- Rebrand commits already in history (gsd → forge)
- Sync pre-existing doc, docker, and CI config updates
- All rebrand artifacts verified in place:
  * Native crates: forge-engine, forge-ast, forge-grep
  * Log prefixes: [forge] across 22+ files
  * Binary: ~/bin/sf-run
  * Workspace scopes: @sf-run/*, @singularity-forge/*
  * Nix flake: Rust toolchain ready

System ready for: nix develop && bun run build:native

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-15 14:54:20 +02:00

2.9 KiB

Raw Blame History

Installation

Install SF

npm install -g sf-run

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 %}

SF 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 SF 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 SF 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

SF is also available as a VS Code extension. Install from the marketplace (publisher: FluxLabs) or search for "SF" in VS Code extensions.

The extension provides:

@gsd chat 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 (sf-run) must be installed first — the extension connects to it via RPC.

Web Interface

SF 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

2.9 KiB Raw Blame History