What is Skein?
Skein is a local execution control plane for coordinating agent processes and other command-line tasks. It runs dependency-based task graphs with bounded concurrency, records run data, and provides an emergency stop that invalidates queued work and rejects late completions from an earlier epoch. It is a Go-based tool with a command-line interface and an embedding API, rather than an agent framework or model runtime. Version 0.2.0 is an early release.
Skein Features:
JSON Task Graphs: Define task arguments and dependencies in JSON manifests, with commands passed as argument arrays rather than through an implicit shell.
Concurrency Limits: Set worker and pass limits to bound how many tasks Skein schedules at once.
Epoch Fencing: A persistent stop latch advances the epoch, invalidates queued work, and rejects late completions from the previous epoch.
Process Tree Termination: An emergency stop terminates tracked local process trees on Linux, macOS, and Windows.
Run Records: Each run can store a report, an event log, leases, and payload data in its run directory.
Multi-Pass Tasks: Manifests support reusable multi-pass blocks, per-pass timeouts, and limits for workers and passes.
Command Line and Go: Use the run, stop, status, and reset commands, or embed Skein through its Go API.
Skein Benefits:
Fewer Stale Results: Rejecting completions from an old epoch helps prevent work finishing after a stop from being treated as current.
Controlled Local Load: Worker limits let teams keep concurrent task execution within a chosen bound.
Cleaner Emergency Stops: Terminating tracked process trees can stop local child processes instead of leaving them running after a task is canceled.
Easier Run Review: Reports and event logs give teams records to inspect when checking what happened during a run.
Script-Friendly Results: Distinct exit codes make it possible for automation to distinguish success, task failure, a stopped run, and operational or usage errors.
Lightweight Setup: The static binary runs without a daemon, database, or runtime dependencies.
Use Cases:
Fan-Out Workflows: Run independent local agent tasks in parallel, then use dependencies to coordinate tasks that must wait for earlier work.
Command Pipelines: Represent a sequence of command-line jobs as a dependency graph when later steps rely on earlier results.
Emergency Halts: Stop a local run when an operator needs queued work invalidated and tracked child processes terminated.
Multi-Pass Jobs: Use reusable multi-pass blocks and per-pass timeouts for command workflows that repeat bounded stages.
Go Integrations: Embed Skein in a Go application when a team wants task-graph execution and stop controls within its own program.

