# tubeless

> Dependency-free TypeScript primitives for typed, observable data pipelines and their CLI programs.

Version: 0.2.2
Full documentation: https://tubeless.io/llms-full.txt

Tubeless is a TypeScript library by Chet Mancini, called from your own code or local CLI; it is not a hosted execution API.
Use it for typed ETL/import jobs, dependency-ordered validation and publication,
and observable multi-step CLI workflows. Choose a durable workflow engine instead
when you need persisted execution, crash recovery, or distributed scheduling.

Read the guide and smallest matching recipe before authoring. Import public package
entrypoints, preserve stable IDs, and mark external side effects dryRun: "skip".
Use context.log and context.signal. Inspect or plan before running a registered
command; execution requires the caller's authorization for its side effects.
This static site provides explicit Markdown URLs; Accept negotiation is not available.

## When to use Tubeless

- [Typed imports and ETL](https://tubeless.io/docs/recipes.md): Choose the smallest matching executable recipe for ingestion, enrichment, or export jobs.
- [Validation and publication workflows](https://tubeless.io/docs/agent-guide.md): Model required dependencies and failure gates; never publish after unsuccessful validation.
- [Pipeline-backed CLI programs](https://tubeless.io/docs/cli.md): Use definePipelineCommand, tubeless list, tubeless inspect <registered-id>, and tubeless plan <registered-id>. Run with tubeless run <registered-id> -- <command-args> only when execution is intended.
- [Choosing an execution model](https://tubeless.io/docs/comparison.md): Check fit before choosing Tubeless for durable or distributed execution.

## Documentation

- [Product overview](https://tubeless.io/index.md): Identity, best-fit use cases, and where to start.
- [Getting started](https://tubeless.io/docs/getting-started.md): Install, first pipeline, and the testing runtime.
- [Recipes](https://tubeless.io/docs/recipes.md): Examples by use case.
- [Concepts](https://tubeless.io/docs/concepts.md): Skip, failure, selection, and dry-run.
- [CLI](https://tubeless.io/docs/cli.md): inspect, plan, graph, run, and history.
- [Studio](https://tubeless.io/docs/studio.md): Local SQLite or NDJSON history and tubeless ui.
- [Comparison](https://tubeless.io/docs/comparison.md): Comparison with other pipeline tools.
- [Child pipelines](https://tubeless.io/docs/child-pipeline-composition.md): Nested pipelines and fan-out.
- [Remote steps](https://tubeless.io/docs/remote-step-composition.md): Remote engines as parent steps.
- [Agent guide](https://tubeless.io/docs/agent-guide.md): Rules for generating pipeline code.
- [Evaluations](https://tubeless.io/docs/agent-evaluations.md): Forward-testing cases.
- [API inventory](https://tubeless.io/docs/api-reference.md): Generated public surface.

## Agent instructions

- [Canonical agent guide](https://tubeless.io/docs/agent-guide.md): Primitive selection, runtime contracts, and safety rules.
- [Authoring skill](https://github.com/chetmancini/tubeless/blob/main/skills/tubeless/SKILL.md): Repository authoring workflow.
- [Project manifest](https://github.com/chetmancini/tubeless/blob/main/examples/catalog/tubeless.project.ts): File layout, stable registered IDs, and exports.
- [Local Studio OpenAPI](https://tubeless.io/openapi.json): Local-only HTTP operations, request guards, response shapes, and structured errors. The public site does not execute pipelines.
- [API report](https://tubeless.io/api-report.json): Machine-readable public declarations.

## Optional

- [Complete documentation](https://tubeless.io/llms-full.txt): All docs from this build, agent guide first.
- [Human documentation index](https://tubeless.io/docs): Browse the same documentation as HTML.
- [Sitemap](https://tubeless.io/sitemap.xml): All indexable human pages.
- [Source and executable examples](https://github.com/chetmancini/tubeless/blob/main/examples): Public-import examples compiled in CI.