CLI reference

CLI reference

Every sparkwing command, flag, and argument, generated from the CLI's own command registry and split into one page per top-level command group. For the conceptual overview -- which binaries exist, the flag-naming rule, and what to reach for when -- see cli.md.

Command groups

• sparkwing cache -- Inspect or trim the compiled pipeline binary cache
• sparkwing cloud -- Connect this machine to a sparkwing controller
• sparkwing cluster -- Operate and inspect the sparkwing cluster
• sparkwing commands -- Index of every command: one path and synopsis per line
• sparkwing completion -- Emit a shell completion script (bash|zsh|fish)
• sparkwing configure -- Configure laptop-local settings
• sparkwing crons -- Arm, inspect and drive this host's local pipeline schedules
• sparkwing daemon -- Inspect or refresh the local admission daemon
• sparkwing debug -- Interactive debugging for pipeline runs
• sparkwing docs -- Embedded user docs (offline)
• sparkwing doctor -- Inspect and repair abandoned local state
• sparkwing examples -- Read complete example pipelines
• sparkwing fleet -- Configure foreground assisted execution
• sparkwing info -- Describe Sparkwing and the selected project
• sparkwing pipeline -- This repo's pipelines
• sparkwing profile -- Show the selected profile and how it was chosen
• sparkwing queue -- Inspect local admission holders, connections, and waiters
• sparkwing repos -- The machine's fleet of sparkwing repos and their SDK pins
• sparkwing run -- Invoke a pipeline
• sparkwing runs -- Inspect and control pipeline runs
• sparkwing secrets -- Manage secrets (local dotenv or controller-stored)
• sparkwing serve -- Manage the local dashboard + API server
• sparkwing update -- Update the CLI binary or this project's SDK pin
• sparkwing version -- Inspect versions (CLI, SDK, sparks)

sparkwing

sparkwing -- CI/CD pipelines written in Go

Sparkwing is a self-hosted pipeline runner. Pipelines are Go programs in a repo's .sparkwing/ directory, triggered by git hooks, webhooks, schedules, or manual invocation. Use 'sparkwing run ' to invoke one; 'sparkwing pipeline list' / 'describe' for agent-facing discovery.

Examples

# Run a pipeline (positional shortcut)
sparkwing run fictional-build

# First command an agent should run
sparkwing info --for-agent

# List every invocable (agents)
sparkwing pipeline list -o json

# Inspect one pipeline's full metadata
sparkwing pipeline describe --name fictional-release -o json

# Bootstrap + scaffold your first pipeline in a new repository
sparkwing pipeline new --name release

# Start the local dashboard
sparkwing serve start