singularity-forge/gitbook

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 autonomous runs 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 singularity-forge

# Launch
sf

# Start autonomous mode
/sf autonomous

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 autonomous	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 26.1.0 or later
• Git installed and configured
• An API key for at least one LLM provider (or use browser sign-in for Anthropic/GitHub Copilot)