README.md

Fusion Documentation

← Back to repository root

Fusion is an AI-orchestrated task board that turns ideas into reviewed, merged code using a structured workflow: planning → todo → in-progress → in-review → done.

Quick Start

Start the local dashboard with pnpm dev dashboard, then create your first task from the board or CLI.

For a full walkthrough (installation, onboarding, first task, and daily workflow basics):

➡️ Getting Started

Documentation Index

Getting Started

Guide	Description
Getting Started	Installation, first-run, first task, and daily workflow basics
Dashboard Guide	Board/list views, terminal, git manager, files, planning, and UI tools
CLI Reference	Complete fn command reference with subcommands, flags, and examples
Remote Access	Operator runbook for Tailscale/Cloudflare setup, tokenized login links, security caveats, and troubleshooting

Task & Project Management

Guide	Description
Task Management	Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration
Missions	Mission hierarchy, planning flow, activation, progress tracking, and autopilot behavior
Workflow Steps	Reusable quality gates, templates, pre/post-merge phases, and workflow execution results
Multi-Project	Central registry architecture, project management, isolation modes, and migration paths

Configuration & Agents

Guide	Description
Settings Reference	Global and project settings, defaults, API endpoints, and model selection hierarchy
Agents	Agent management, presets, prompts, heartbeat behavior, spawning, and mailbox workflows

Architecture & Development

Guide	Description
Architecture	System architecture, package layout, storage model, and engine execution flow
Storage	Storage architecture, migration, archive system, and SQLite schema
Contributing	Local development setup, testing, release flow, and contributor conventions
Docker	Container builds, deployment, and persistence configuration
Code Signing	macOS and Windows code signing configuration for release binaries
Mobile	Capacitor/PWA mobile development setup and workflow

Plugin Development

Guide	Description
Plugin Authoring	Creating Fusion plugins with the plugin system
Memory Plugin Contract	Pluggable memory backend architecture, interface contract, and migration strategy

Audit Reports

Report	Description
UX Audit Report	Comprehensive UX audit with prioritized recommendations for dashboard improvements
Codebase Improvement Audit	Evidence-based technical debt and reliability gap audit with prioritized recommendations
Gap Analysis	System completeness analysis comparing Fusion to Paperclip feature set
Agent Sandbox Research	Research on agent isolation, capability enforcement, and sandboxing approaches
Agent Gap Analysis	Gap analysis for agent Paperclip integration
Test Audit Report	Test coverage and effectiveness audit with recommendations
Skipped Test Inventory	Current intentional test-skip inventory and reconciliation status for older skip follow-ups
Dev Server Module Boundary Audit	Boundary/ownership audit for parallel dev-server-* vs devserver-* dashboard modules and FN-2212 prioritization guidance
Dashboard Load Performance	SQLite index analysis and optimization for dashboard boot path queries

External Resources

• GitHub repository: https://github.com/Runfusion/Fusion
• npm package: https://www.npmjs.com/package/@runfusion/fusion
• pi agent framework: https://github.com/badlogic/pi-mono

Suggested Reading Paths

• New user: Getting Started → Dashboard Guide → Task Management
• Power user / automation owner: Settings Reference → Workflow Steps → Agents
• Maintainer / contributor: Architecture → Multi-Project → Contributing