Fusion

First-run setup

On first launch, Fusion opens the onboarding wizard with three guided steps:

1. AI Setup — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand Advanced provider settings only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
2. GitHub (Optional) — Connect GitHub for issue import and PR management
3. First Task — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)

The wizard is dismissible and non-blocking — click Skip for now to use the dashboard immediately. Re-trigger it later from Settings → Authentication → Reopen onboarding guide.

Build a standalone executable

Build a single self-contained fn binary using Bun:

pnpm build:exe                # Build for current platform
pnpm build:exe:all            # Cross-compile for all platforms

---

Quick start

Zero install, straight from npm:

npx runfusion.ai

That launches the dashboard. Subcommands forward through: npx runfusion.ai task create "fix X", npx runfusion.ai --help, etc. (Or verbosely: npx @runfusion/fusion dashboard.)

One-line installer (macOS & Linux — auto-picks Homebrew, falls back to npm):

curl -fsSL https://runfusion.ai/install.sh | sh
fusion dashboard

Homebrew (macOS & Linux):

brew tap runfusion/fusion
brew install fusion
fusion dashboard            # or: fn dashboard

Or as a one-liner (auto-taps): brew install runfusion/fusion/fusion.

npm global:

npm install -g @runfusion/fusion
fn dashboard                # or: fusion dashboard

From a clone (for development):

pnpm dev dashboard

Then click the Open: URL printed in the terminal. It embeds a bearer token (http://localhost:4040/?token=fn_...) that the browser captures to localStorage on first visit and reuses automatically thereafter. On the server side, Fusion now persists the dashboard/daemon token in ~/.fusion/settings.json on first authenticated run and reuses it on later starts unless you override it (--token, FUSION_DASHBOARD_TOKEN, FUSION_DAEMON_TOKEN) or disable auth with --no-auth. See CLI reference → fn dashboard → Authentication for full precedence and reset/revocation options.

CLI quick examples

fn task create "Fix the login bug"                    # Quick entry → planning
fn task plan "Build auth system"                      # AI-guided planning
fn task import owner/repo --labels bug                # Import GitHub issues
fn task show FN-001                                   # View task details
fn task logs FN-001 --follow                          # Stream execution logs
fn task steer FN-001 "Use TypeScript"                 # Guide the agent mid-execution

fn project add my-app /path/to/app                    # Register a project
fn project list                                       # List all projects

fn settings set maxConcurrent 4                       # Configure settings
fn settings export                                    # Export configuration

fn mission create "Auth System" "Build auth"          # Create mission
fn mission activate-slice <slice-id>                  # Activate a slice

fn skills search react                                # Search skills.sh
fn skills install firebase/agent-skills               # Install agent skills

---

Your entire dev environment. On a single pane of glass.

Describe a task in plain language. A planning agent reads your project, understands context, and writes a full PROMPT.md plan — steps, file scope, acceptance criteria. Then Fusion plans, reviews, executes, and reviews again, in an isolated git worktree, with a human approval gate wherever you want one.

One board. Controlled from anywhere. Laptop, Mac mini, Linux server, cloud VM, phone — all connected.

Like Trello, but your tasks get specified, executed, and delivered by AI. Built on the great work of dustinbyrne/kb.

---

Packages

---