Pipelines

Reusable, sequential workflows for your repositories. A Go CLI/TUI and native server reuse your OpenCode login; Docker ntfy handles phone notifications.

Install

Requires Go 1.27+ to install. Use your existing OpenCode for model stages; Docker/ntfy notifications are optional.

git clone https://git.a-wan.net/alan/pipelines.git
cd pipelines
./install.sh
pipelines help

Go uses GOBIN or its normal GOPATH/bin default; put that directory on PATH. ./install.sh installs the Go binaries and the shared OpenCode pipelines skill. There are no login checks, dependency installers, hardcoded install paths, or automatic services. With plain go install ./cmd/..., also run pipelines skill install. For system-wide use, install the binaries into your chosen system bin directory with the appropriate permissions. Configuration and data remain per-user.

Start explicitly; fresh databases contain no pipelines:

pipelines serve   # foreground server
# In another terminal:
pipelines

Optional autostart at login (starts the server now):

pipelines service enable
pipelines service status

Uses user-level systemd on Linux or launchd on macOS; no sudo. Runs use the directory you invoke pipelines run from. Preview with --print. Stop any existing foreground/legacy server first. Disable with pipelines service disable before uninstalling. See installation for environment and boot options.

Uninstall

pipelines uninstall          # remove Go binaries; keep history, drafts, and ntfy data

A three-stage pipeline

Plan → Implement → Review. Each stage receives the previous stage's output; the first receives your task prompt. One outcome selects the next stage—no parallel branches. Definitions use Markdown output, prompt, tools, configs, and edges blocks. For example:

# stage planner

```output
{ task, plan, acceptance_checks }
```

```prompt
Turn input.prompt into a focused plan and acceptance checks.
```

```tools
```

```configs
provider=opencode-go
model=deepseek-v4.1-flash
retries=0
```

```edges
success -> implementer
error -> #failure
```

The complete three-stage example adds the implementer and reviewer. Review and explicitly submit it:

pipelines validate examples/three-stage.md
pipelines submit examples/three-stage.md --name "three stage" --create-only
pipelines run "three stage"

Every submission is validated and creates an immutable version. Examples are optional; nothing is imported automatically. Run from your repository directory; stage tools are enabled automatically. Edits support any language/file type and new files. No file list or typed RUN confirmation is required.

Useful commands

pipelines                                  # dashboard; b browses templates
pipelines list
pipelines run                              # fuzzy selection + multiline prompt
pipelines run "bug fix" "Fix the layout"     # run in the current repository
pipelines new "daily digest" "Summarize changes"
pipelines edit "bug fix" "Add a review step"
pipelines drafts --json
pipelines validate /path/to/draft.md
pipelines submit /path/to/draft.md           # explicit publication
pipelines runs
pipelines inspect 1
pipelines serve                            # foreground server; Ctrl+C stops it
pipelines ping
pipelines help edit

new/edit open OpenCode directly with @pipelines. The installed skill asks missing questions; pipelines new needs no preliminary questionnaire. Changes stay as drafts by default; CLI and TUI share validation and draft storage. Most commands support --json for agents and scripts.

In the TUI, press d (or use :drafts) to browse retained drafts, including CLI-created ones. e reopens a draft, v validates it, and s opens explicit submission confirmation. Drafts remain retained after submission.

From a run, press p / :pipeline to open the pipeline version it used. Initial run input also records pwd. Press r / :retry on a failed run (or pipelines retry <run-id>) to start a new attempt with the same original input, directory, and pipeline version. Completed side effects are not undone.

More: CLI · installation · pipeline format.

S
Description
No description provided
Readme 78 MiB
Languages
Dart 51.6%
Go 36.7%
JavaScript 7.6%
Python 3.4%
Kotlin 0.4%
Other 0.1%