Getting Started with SageForge

SageForge is a local-first desktop command center for running AI coding agents against your own Git repos — safely. This guide takes you from install to your first reviewed, agent-made change.

Requirements

• Windows 11 (or a recent Windows 10) with the WebView2 runtime — the alpha is Windows-first.
• Git on your PATH.
• At least one AI coding agent CLI you want to launch: claude (Claude Code), codex, or pi.
• Optional: Windows Terminal or Warp for launching interactive agents.

macOS and Linux builds are in progress.

Install

SageForge is in pre-alpha. During early access, builds are sent to waitlist members.

1. Join the waitlist and accept your early-access invite.
2. Download and run the SageForge installer for your platform.
3. Launch the app — it's fully local, so there's no account to create.

Your first task

1. Add a project — point SageForge at any local Git repo.
2. Init the project brain — this writes a few templated markdown files under .sagerift/ (project notes, coding rules, review rules) that travel with your repo.
3. Create a task — give it a title, acceptance criteria, and allowed_files / blocked_files globs so the agent stays in its lane.
4. Create the worktree — one click adds an isolated git worktree on a dedicated branch for that task.
5. Launch an agent — start Claude Code, Codex, or pi in that worktree. Keep one agent per worktree.
6. Run checks — run your build/test/lint commands so their results are captured for the review gate.
7. Review & approve — inspect the diff, confirm scope and checks are clean, and approve. Then stage, commit, and merge yourself.

What SageForge will not do

It never auto-commits, auto-pushes, auto-merges, or deletes branches and worktrees. Those irreversible Git actions are always yours — SageForge just makes the agent's work safe to ship.

Next

• Core Concepts — worktrees, scope, and the review gate
• Learn — running agents safely
• Pricing — join the waitlist for early access