- 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>
2.5 KiB
2.5 KiB
What is SF?
SF is an AI-powered development agent that turns project ideas into working software. Describe what you want to build, and SF researches, plans, codes, tests, and commits — with clean git history and full cost tracking.
How It Works
SF breaks your project into manageable pieces and works through them systematically:
You describe your project
↓
SF creates a milestone with slices (features)
↓
Each slice is decomposed into tasks
↓
Tasks are executed one at a time in fresh AI sessions
↓
Code is committed, verified, and the next task begins
You can stay hands-on with step mode (reviewing each step) or let SF run autonomously with auto mode while you grab coffee.
Key Features
- Autonomous execution —
/sf autoruns research, planning, coding, testing, and committing without intervention - 20+ LLM providers — Anthropic, OpenAI, Google, OpenRouter, GitHub Copilot, Amazon Bedrock, local models, and more
- Git isolation — Each milestone works in its own worktree branch, merged cleanly when done
- Cost tracking — Real-time token usage, budget ceilings, and automatic model downgrading
- Crash recovery — Sessions resume automatically after interruptions
- Skills system — Domain-specific instruction sets for frameworks, languages, and tools
- Parallel milestones — Run multiple milestones simultaneously in isolated worktrees
- Remote questions — Get Discord, Slack, or Telegram notifications when SF needs input
- Web interface — Browser-based dashboard with real-time progress
- VS Code extension — Chat participant, sidebar dashboard, and full command palette
- Headless mode — Run in CI pipelines, cron jobs, and scripted automation
Quick Start
# Install
npm install -g sf-run
# Launch
sf
# Start autonomous mode
/sf auto
See Installation for detailed setup instructions.
Two Ways to Work
| Mode | Command | Best For |
|---|---|---|
| Step | /sf |
Staying in the loop, reviewing each step |
| Auto | /sf auto |
Walking away, overnight builds, batch work |
The recommended workflow: run auto mode in one terminal, steer from another. See Step Mode and Auto Mode.
Requirements
- Node.js 24.0.0 or later (24 LTS recommended)
- Git installed and configured
- An API key for at least one LLM provider (or use browser sign-in for Anthropic/GitHub Copilot)