Skip to content
Archont561Public

About

Native Python and TypeScript file-based task runner.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Tasknest

████████╗ █████╗ ███████╗██╗  ██╗███╗   ██╗███████╗███████╗████████╗
╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝████╗  ██║██╔════╝██╔════╝╚══██╔══╝
   ██║   ███████║███████╗█████╔╝ ██╔██╗ ██║█████╗  ███████╗   ██║
   ██║   ██╔══██║╚════██║██╔═██╗ ██║╚██╗██║██╔══╝  ╚════██║   ██║
   ██║   ██║  ██║███████║██║  ██╗██║ ╚████║███████╗███████║   ██║
   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝   ╚═╝

Version: 0.4.0 Status: scaffold Documentation python 3.10+ bun 1.4+ node 20+ License: MIT

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 and packages/tasknest-ts/ implements the M1–M4 TypeScript runner (Bun & Node.js); repository automation in tools/ dogfoods Tasknest itself.

Documentation

Project specifications, accepted decisions, and milestones live in backlog/:

Planned work is tracked in backlog/tasks/ and backlog/milestones/. Inspect the plan with pixi run backlog task list --plain.

Install & Development

Install Pixi, then set up the locked workspace and hooks:

pixi install --locked
pixi run bun-install
pixi run hooks-install

pixi 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.

Run checks & tests

pixi run tools run check
pixi run tools run test

Layout

  • packages/tasknest-py/ and packages/tasknest-ts/: native Python and TypeScript task runners
  • tools/: repository automation tasks executed by Tasknest
  • templates/: Jinja2 sources for this README and AGENTS.md
  • tasknest.toml: Tasknest workspace configuration
  • pixi-sandbox.toml and scripts/restore.sh: offline sandbox configuration and restore launcher; see offline setup
  • backlog/: milestones, tasks, ADRs, and specification docs

Author

👤 Tasknest contributors

🤝 Contributing

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.

Show your support

Give a ⭐️ if this project helped you!

📝 License

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.

About

Native Python and TypeScript file-based task runner.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages