Tooling & Workspace

Putnami is a workspace-first polyglot build system. One CLI orchestrates builds, tests, linting, serving, and publishing across TypeScript, Go, and Python — and any language you add through extensions.

This section explains the system: how workspaces organize projects, how the CLI runs jobs, and how extensions make the whole thing pluggable.

Workspace — projects, scopes, dependency graph, and the --impacted model
CLI — commands, flags, aliases, output modes, and shell completion
Jobs & caching — orchestration, dependencies, caching, watch mode
Extensions — discovery, manifest, JSONL protocol, writing your own
Templates — scaffold, publish, and install project templates
Error handling — diagnostics, retries, exit codes

Tooling & Workspace

This section explains the system: how workspaces organize projects, how the CLI runs jobs, and how extensions make the whole thing pluggable.

Workspace — projects, scopes, dependency graph, and the --impacted model
CLI — commands, flags, aliases, output modes, and shell completion
Jobs & caching — orchestration, dependencies, caching, watch mode
Extensions — discovery, manifest, JSONL protocol, writing your own
Templates — scaffold, publish, and install project templates
Error handling — diagnostics, retries, exit codes