What problem does it solve?
Ensures reliable, deterministic management of repo-scoped tasks by standardizing how agents and humans create, transition, and inspect tasks while keeping markdown files as the single source of truth. It prevents unsafe direct edits to supporting caches and enforces guardrails around single-writer transitions and repository-aware command execution.
Core Features & Use Cases
- Create canonical task files: Use the CLI to generate new .volon/tasks markdown files with the required frontmatter.
- Deterministic state transitions: Move tasks through lifecycle states (todo → doing → done) with idempotent commands and appended update history.
- Listing and inspection: Query and show tasks without manually grepping the tasks directory.
- Cache maintenance: Rebuild or reindex the SQLite cache after manual edits, schema changes, or corruption.
- Use Case: An agent finishing a task runs volon task done <id> from the repo root, which appends the update and avoids touching the underlying Nanite databases.
Quick Start
Run the volon task create "Your Task Title" command from the repository root to add a new markdown task with canonical frontmatter.