Skip to content

dockpipe v0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@jamie-steele jamie-steele released this 17 Mar 23:51
· 992 commits to master since this release
v0.1.0
95f5b61

First public release.

Run, isolate, and act — pipe commands into disposable containers and act on the results.

What is dockpipe?

dockpipe is a minimal CLI built around one primitive:

spawn → run → act

  1. Spawn a disposable container from an image.
  2. Run your command or script inside it (your directory is mounted at /work).
  3. Optionally run an action on the result (e.g. commit, export patch).

It’s composable and command-agnostic: the same flow works for any tool, script, or AI assistant.

Features

  • Disposable container execution — Run commands in isolated environments; no pollution of your host.
  • Pipe-friendly — Stdin and stdout work naturally (e.g. pipe a prompt in, pipe output out).
  • Composable — Use with your own scripts and actions; chain with other tools.
  • Command-agnostic — Works with any CLI, script, or binary. AI tools (Claude, Codex, etc.) are one use case, not the only one.
  • Lightweight — Bash and Docker only; no extra runtime dependencies.

Example

Pipe in a task, run Claude in a container, commit the result:

echo "refactor the auth module" \
  | dockpipe --template claude --action examples/actions/commit-worktree.sh \
  -- claude --dangerously-skip-permissions -p "$(cat)"

Generic command (default image):

dockpipe -- ls -la
dockpipe -- bash -c "npm test"

Installation (Linux)

wget https://github.com/jamie-steele/dockpipe/releases/download/v0.1.0/dockpipe_0.1.0_all.deb
sudo apt install ./dockpipe_0.1.0_all.deb

Requires Bash and Docker (docker.io or docker-ce). If apt reports missing deps: sudo apt install -f.

Notes

  • Early release focused on the core primitive.
  • Includes example workflows (e.g. Claude + worktree + commit) under examples/.
  • More templates, actions, and packaging options may follow based on feedback.

Philosophy

dockpipe is intentionally minimal. It does not manage workflows, enforce structure, or provide orchestration. It provides a small execution primitive you compose with existing tools.

Feedback and ideas welcome: https://github.com/jamie-steele/dockpipe

Assets 3
Loading