Spark Docs

Describe a goal, turn it into verifiable tasks, and supervise the implementation from the terminal or Cockpit.

Spark is a controlled coding-agent suite with one public spark command and three product surfaces:

the TUI for interactive work,
the daemon for durable sessions and background work, and
Cockpit for web-based control and projection.

Start with installation and your first run, then plan and implement a change. Learn the complete feature map when you want to see how CLI, daemon, TUI, Cockpit, tools, automation, and collaboration fit together. Read surface ownership only when you need to automate, operate remotely, or diagnose the system.

What this documentation covers

installing the published npm product,
choosing foreground, background, TUI, or Cockpit workflows,
resuming workspace-bound sessions,
supervising tasks, automation, channels, and multi-session collaboration,
inspecting configuration and state paths, and
diagnosing common local and remote-access failures.

The implementation repository remains the source of truth. User-facing command examples in this site are checked against the source spark --help dispatcher.