████████╗ █████╗ ███████╗██╗ ██╗███╗ ██╗███████╗███████╗████████╗ ╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝████╗ ██║██╔════╝██╔════╝╚══██╔══╝ ██║ ███████║███████╗█████╔╝ ██╔██╗ ██║█████╗ ███████╗ ██║ ██║ ██╔══██║╚════██║██╔═██╗ ██║╚██╗██║██╔══╝ ╚════██║ ██║ ██║ ██║ ██║███████║██║ ██╗██║ ╚████║███████╗███████║ ██║ ╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝╚══════╝ ╚═╝
Native Python and TypeScript file-based task runners with shared conventions.
Tasknest is a file-oriented task runner targeting task registration, dependencies, quality gates, CLI arguments, parallel execution, caching, watch mode, and execution reports.
packages/tasknest-py/implements the M1–M4 Python runner andpackages/tasknest-ts/implements the M1–M4 TypeScript runner (Bun & Node.js); repository automation intools/dogfoods Tasknest itself.
🏠 Homepage
Project specifications, accepted decisions, and milestones live in
backlog/:
- Project vision and current state: scope, non-goals, and what exists today
- Runner model and CLI contract: proposed discovery, CLI, and validation contract
- Repository development and offline workflow: development tools and workflow notes
- Adapter and testing design: proposed adapters and testing utilities
- Future capabilities and safety: proposed caching, parallelism, and safety model
- Pixi sandbox offline setup:
pixi-sandboxbundle configuration and offline restore notes - Architecture decisions: accepted design decisions (
decision-1throughdecision-9) - Agent instructions: contributor and agent guidelines
Planned work is tracked in backlog/tasks/ and backlog/milestones/. Inspect the plan with pixi run backlog task list --plain.
Install Pixi, then set up the locked workspace and hooks:
pixi install --locked
pixi run bun-install
pixi run hooks-installpixi run tools runs Tasknest directly against tools/ (tasknest.toml). List available automation tasks with pixi run tools ls, validate the task graph with pixi run tools check, and run tasks with pixi run tools run <task>. Use pixi run tools run docs_write after editing templates/; CI runs docs_check. Python compatibility environments are defined in tox.ini. Bun installs the pinned repository CLIs from bun.lock; invoke them using pixi run skills and pixi run backlog.
pixi run tools run check
pixi run tools run testpackages/tasknest-py/andpackages/tasknest-ts/: native Python and TypeScript task runnerstools/: repository automation tasks executed by Tasknesttemplates/: Jinja2 sources for this README andAGENTS.mdtasknest.toml: Tasknest workspace configurationpixi-sandbox.tomlandscripts/restore.sh: offline sandbox configuration and restore launcher; see offline setupbacklog/: milestones, tasks, ADRs, and specification docs
👤 Tasknest contributors
- Website: archont561.github.io/Archont561
- GitHub: @Archont561
Contributions, issues and feature requests are welcome!
Feel free to check
the issues page. You can also review
AGENTS.md and backlog/docs/ for repository
conventions and quality checks.
Give a ⭐️ if this project helped you!
Copyright © 2026 Tasknest contributors.
This project is MIT licensed.
This README was generated from templates/README.md.j2 via pixi run tools run docs_write.