pocket

Pocket core engine architecture and internals. Covers plan building, task execution, composition, context propagation, path resolution, deduplication, output buffering, exec pipeline, and shim generation. Use when modifying or understanding code in the pk/ package.

Guide for adding new tasks to Pocket. Covers task structure, naming, flags, verbose handling, cross-platform support, composition, and wiring into config. Use when creating or modifying task files under tasks/ or wiring tasks in .pocket/config.go.

Guide for adding new tools (binaries, linters, formatters) to Pocket. Covers Go packages, GitHub release binaries, Python/uv tools, and Node/bun tools. Use when creating a new tool package under tools/ or modifying an existing tool's installation, versioning, or cross-platform support.