Mikael Hugo d73a73d7f3 chore: node 24 native APIs, import.meta.dirname, parsers rename, dep updates

- Replace fileURLToPath(import.meta.url) with import.meta.dirname across
  scripts and extensions
- Rename parsers-legacy.ts → parsers.ts
- Remove deleted plan/spec docs (cicd-pipeline)
- Update package.json engines and deps across workspace packages
- Update web/package-lock.json

💘 Generated with Crush

Assisted-by: GLM-5.1 via Crush <crush@charm.land>

2026-05-02 06:18:25 +02:00

2.9 KiB

Raw Blame History

Installation

Install SF

npm install -g sf-run

Requires Node.js 24.0.0 or later (24 LTS recommended) and Git.

{% hint style="info" %} command not found: sf? 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 /sf update.

Set Up Your LLM Provider

Launch SF for the first time:

sf

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:

sf 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 /sf config inside any SF session to set keys globally — they're saved to ~/.sf/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:

@sf 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:

sf --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 sf command conflicts with another tool (e.g., the oh-my-zsh git plugin aliases sf to git svn dcommit), use the alternative:

sf-cli

Both sf and sf-cli point to the same binary. To remove the conflict permanently, add this to your ~/.zshrc:

unalias sf 2>/dev/null

2.9 KiB Raw Blame History