{"_id":"@caio.silveira/taskkit","_rev":"3-7d81da987143bb4bdf782223fe5e7a56","name":"@caio.silveira/taskkit","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@caio.silveira/taskkit","version":"0.1.0","keywords":["taskkit","project-management","task-manager","local-first","ai-first","state-engine","cli"],"author":{"name":"Caio Silveira"},"license":"MIT","_id":"@caio.silveira/taskkit@0.1.0","maintainers":[{"name":"caio.silveira","email":"caiosilveira63@gmail.com"}],"homepage":"https://github.com/CaioSilveira63/Taskkit#readme","bugs":{"url":"https://github.com/CaioSilveira63/Taskkit/issues"},"bin":{"taskkit":"dist/index.js"},"dist":{"shasum":"525e57c9feecca88fdda4bdea6a23e28e0f410ed","tarball":"https://registry.npmjs.org/@caio.silveira/taskkit/-/taskkit-0.1.0.tgz","fileCount":4,"integrity":"sha512-44Y5XNqYpH4iCS9jXhP+rsyBkb3WPlm+kjK+jurifvXjmkGe8EXbAIqnQU02/tOdycLgsEsHp1BgVHET4EPzFg==","signatures":[{"sig":"MEUCIA8OlRdXazdD5K4AiTpr25R0Q7GvbRHLHND8E3ROTqx/AiEA39MEQcklDwyxlnXiMBm7OnKAlxliD3zvoeB3j0p7ls4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56211},"type":"module","gitHead":"35af9f35ffdf6f19fae355ee7255f898b001baaa","scripts":{"test":"node --test dist/**/*.test.js","build":"tsc","coverage":"node --experimental-test-coverage --test dist/**/*.test.js"},"_npmUser":{"name":"caio.silveira","email":"caiosilveira63@gmail.com"},"repository":{"url":"git+https://github.com/CaioSilveira63/Taskkit.git","type":"git"},"_npmVersion":"11.12.1","description":"CLI interface for Task Kit, a local-first, AI-first project state engine","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@clack/prompts":"^1.7.0","@caio.silveira/taskkit-core":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/taskkit_0.1.0_1784167081169_0.29677192008281605","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@caio.silveira/taskkit","version":"0.1.1","keywords":["taskkit","project-management","task-manager","local-first","ai-first","state-engine","cli"],"author":{"name":"Caio Silveira"},"license":"MIT","_id":"@caio.silveira/taskkit@0.1.1","maintainers":[{"name":"caio.silveira","email":"caiosilveira63@gmail.com"}],"homepage":"https://github.com/CaioSilveira63/Taskkit#readme","bugs":{"url":"https://github.com/CaioSilveira63/Taskkit/issues"},"bin":{"taskkit":"dist/index.js"},"dist":{"shasum":"18f14f09189554836ffe39200bc046bc798a5e0f","tarball":"https://registry.npmjs.org/@caio.silveira/taskkit/-/taskkit-0.1.1.tgz","fileCount":5,"integrity":"sha512-2Ew3cMh6kjzVCy6QA1zAtQDYmwRMpN+X2Rrnl0iBr8xB9pP9mc3biZx5N4xL+AVslvYICv7wEu9iQEeUHaB6ww==","signatures":[{"sig":"MEYCIQCAdgphlGK2o1+8JEfkl38s8+KEIw2IQaNPSqG6grb2YQIhAJDvUXoQRpF5JszQSHzWjLAPcU8TpIkkvEZNGYmYICsC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59063},"type":"module","gitHead":"35af9f35ffdf6f19fae355ee7255f898b001baaa","scripts":{"test":"node --test dist/**/*.test.js","build":"tsc","coverage":"node --experimental-test-coverage --test dist/**/*.test.js"},"_npmUser":{"name":"caio.silveira","email":"caiosilveira63@gmail.com"},"repository":{"url":"git+https://github.com/CaioSilveira63/Taskkit.git","type":"git"},"_npmVersion":"11.12.1","description":"CLI interface for Task Kit, a local-first, AI-first project state engine","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@clack/prompts":"^1.7.0","@caio.silveira/taskkit-core":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/taskkit_0.1.1_1784167393938_0.4496037210925634","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@caio.silveira/taskkit","version":"0.1.2","description":"CLI interface for Task Kit, a local-first, AI-first project state engine","type":"module","author":{"name":"Caio Silveira"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/CaioSilveira63/Taskkit.git"},"bugs":{"url":"https://github.com/CaioSilveira63/Taskkit/issues"},"homepage":"https://github.com/CaioSilveira63/Taskkit#readme","keywords":["taskkit","project-management","task-manager","local-first","ai-first","state-engine","cli"],"bin":{"taskkit":"dist/index.js"},"scripts":{"build":"tsc","test":"npm run build && node --test dist/**/*.test.js","coverage":"npm run build && node --experimental-test-coverage --test dist/**/*.test.js"},"dependencies":{"@clack/prompts":"^1.7.0","@caio.silveira/taskkit-core":"^0.1.0"},"gitHead":"4ec9a7323391f9bedb0003f9e38472c566993c35","_id":"@caio.silveira/taskkit@0.1.2","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-C9qNzO53A/EfLmCoBkZV0lId4fcBWGKR6JICUyx0F+O6aDJL4x85Sz6bQjXqk4ow+EidFN09dc7zorPv9mPaeQ==","shasum":"16c27d6681b6c25113939eeb2b314165f8f621c9","tarball":"https://registry.npmjs.org/@caio.silveira/taskkit/-/taskkit-0.1.2.tgz","fileCount":5,"unpackedSize":76058,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEgjSBw5G3Snr1PhzJsqgw8ta1ktEHihjP/uAjueAnHCAiEA7MLrgNSP7OSTQT7yu1JTZH4IaQUUCP74X+yvk2EOOfs="}]},"_npmUser":{"name":"caio.silveira","email":"caiosilveira63@gmail.com"},"directories":{},"maintainers":[{"name":"caio.silveira","email":"caiosilveira63@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/taskkit_0.1.2_1785982206361_0.11799207110659937"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-16T01:58:00.972Z","modified":"2026-08-06T02:10:06.665Z","0.1.0":"2026-07-16T01:58:01.342Z","0.1.1":"2026-07-16T02:03:14.119Z","0.1.2":"2026-08-06T02:10:06.493Z"},"bugs":{"url":"https://github.com/CaioSilveira63/Taskkit/issues"},"author":{"name":"Caio Silveira"},"license":"MIT","homepage":"https://github.com/CaioSilveira63/Taskkit#readme","keywords":["taskkit","project-management","task-manager","local-first","ai-first","state-engine","cli"],"repository":{"type":"git","url":"git+https://github.com/CaioSilveira63/Taskkit.git"},"description":"CLI interface for Task Kit, a local-first, AI-first project state engine","maintainers":[{"name":"caio.silveira","email":"caiosilveira63@gmail.com"}],"readme":"# Task Kit CLI\n\nTask Kit is a local-first, AI-first project state engine for software development.\n\nInstead of replacing Jira, Linear, or GitHub issues, Task Kit provides a structured, lightweight hierarchy interface for representing the execution state of your project. It is designed to be equally easy to navigate for both humans and AI agents.\n\n---\n\n## Key Features\n\n- 🛠️ **Methodology Agnostic**: No hardcoded Epics, Sprints, or Stories. Task Kit provides generic nodes that can represent tasks, milestones, research topics, or whatever fits your workflow.\n- 🌲 **Tree Navigation**: Model tasks as a deep tree hierarchy instead of flat lists or queues.\n- 🤖 **AI-First & Onboarding**: Onboards AI agents by providing clean CLI tools and auto-generated instructions (`.task/onboarding.md`), reducing context usage and parsing errors.\n- ⏱️ **Agent Checkpoints**: Save agent progress checkpoints (`summary`, `activeFiles`, `nextSteps`, `dirtyState`) so subsequent agents can resume interrupted tasks seamlessly.\n- 📂 **Local-First & Git-Friendly**: Stores data inside `.task/` in your repository. Supports version-controlled layouts or local-only untracked states.\n- 🔒 **File Locking & Migrations**: Prevents race conditions with automatic file locking and ensures safe data upgrades with schema migrations.\n- ⚡ **Zero-Config Setup**: Get started in just a few seconds with interactive presets.\n\n---\n\n## Installation & Setup\n\nInstall the CLI tool globally via npm:\n\n```bash\nnpm install -g @caio.silveira/taskkit\n```\n\nOr run it directly without installing using `npx`:\n\n```bash\nnpx @caio.silveira/taskkit <command>\n```\n\n---\n\n## Quick Start\n\n1. **Initialize a workspace**:\n   Create a new Task Kit state inside your project directory.\n   ```bash\n   taskkit init --template scrum\n   ```\n\n2. **Display workspace status**:\n   View a quick dashboard of open/completed tasks, active checkpoints, and next recommendations:\n   ```bash\n   taskkit status\n   ```\n   *Tip: Running `taskkit` with no arguments also displays this status dashboard.*\n\n3. **Display active task tree**:\n   ```bash\n   # Shows only open tasks by default to save context tokens\n   taskkit tree\n\n   # Shows all tasks including completed/archived ones\n   taskkit tree --all\n   ```\n\n4. **Add a task**:\n   ```bash\n   taskkit create \"Implement JWT Auth\" --parent Backlog --desc \"Add auth middleware\" --tags backend,auth\n   ```\n\n5. **Change task status**:\n   ```bash\n   # Move task to Development folder\n   taskkit move backlog/implement-jwt-auth development\n\n   # Mark task completed\n   taskkit complete development/implement-jwt-auth\n   ```\n\n6. **Get recommendations**:\n   Get suggestions on what leaf tasks are ready to focus on:\n   ```bash\n   taskkit recommend\n   ```\n\n7. **Save progress & resume (Agent Checkpointing)**:\n   Save context when rate limits are low or to hand over tasks:\n   ```bash\n   # Save a progress checkpoint\n   taskkit checkpoint backlog/implement-jwt-auth --summary \"Auth setup done\" --files \"src/auth.ts\" --next \"Write tests\"\n\n   # View active progress checkpoint to resume\n   taskkit resume backlog/implement-jwt-auth\n   ```\n\n8. **Migrate data schema**:\n   Safe database migrations as the schema evolves:\n   ```bash\n   taskkit migrate\n   ```\n","readmeFilename":"README.md"}