fusion/packages/cli/skill/fusion/workflows/dashboard-cli.md

<required_reading>

• references/cli-commands.md — Full CLI command reference </required_reading>

Guide the agent through using the Fusion dashboard and CLI for operations not available via extension tools.

Starting the dashboard:

Use the /fn command (registered by the Fusion extension):

• /fn or /fn 4040 — Start dashboard + AI engine on specified port (default 4040)
• /fn stop — Stop the dashboard
• /fn status — Check if dashboard is running

The dashboard provides:

• Real-time kanban board with drag-and-drop
• Task detail modal with tabs: Details, Spec, Model, Workflow, Comments
• Git manager (commits, branches, worktrees)
• Activity log
• Settings configuration
• Workflow step manager
• Mission hierarchy view (Cmd/Ctrl+Shift+M)
• GitHub import modal
• Theme system (8+ themes, dark/light/system)

Operations that require CLI or dashboard:

These cannot be done with extension tools:

Operation	CLI Command	Dashboard
Move task to column	fn task move FN-001 todo	Drag card between columns
Merge completed task	fn task merge FN-001	Click merge in task detail
Add steering comment	fn task steer FN-001 "Use TypeScript"	Comments tab in task detail
Add general comment	fn task comment FN-001 "Looks good"	Comments tab in task detail
View agent logs	fn task logs FN-001 --follow	Agent log tab in task detail
Change settings	fn settings set maxConcurrent 4	Settings modal
Create workflow steps	—	Workflow Steps button in header
Git operations	fn git status/fetch/pull/push	Git manager panel

Settings overview:

Key settings (configure via dashboard Settings or fn settings set):

Setting	Default	Description
maxConcurrent	2	Concurrent task execution slots
autoMerge	true	Auto-merge completed tasks to main
requirePlanApproval	false	Manual approval for AI specifications
prCompletionMode	"direct"	How tasks complete: "direct" (squash merge) or "pr-first" (GitHub PR)
recycleWorktrees	false	Pool and reuse git worktrees
taskStuckTimeoutMs	—	Timeout for detecting stuck tasks (ms)
autoBackupEnabled	false	Automatic database backups
ntfyEnabled	false	Push notifications via ntfy.sh

Working with GitHub PRs:

When prCompletionMode is set to "pr-first":

• Completed tasks create a GitHub PR instead of direct-merging
• Use fn task pr-create FN-001 to manually create a PR for any in-review task
• PRs can be reviewed and merged through the normal GitHub workflow

Backup operations:

fn backup --create         # Create a backup now
fn backup --list           # List all backups
fn backup --restore <file> # Restore from backup
fn backup --cleanup        # Remove old backups

Multi-project support:

If managing multiple projects, use --project flag:

fn task list --project my-app
fn task create "Fix bug" --project api-service
fn project list              # List all registered projects
fn project add my-app /path  # Register a project
fn project set-default main  # Set default project

<success_criteria>

• Agent knows when to direct user to dashboard vs. CLI
• Settings are configured appropriately for the project's needs
• Dashboard is accessible and running when needed </success_criteria>