taskroot 0.1.2

Project-local Markdown task tracking for humans and coding agents
Documentation

Taskroot

Taskroot keeps project work in structured Markdown files under .tasks/. The files stay readable, reviewable in Git, and available to both people and coding agents without a hosted issue tracker.

Taskroot provides:

  • project-local domains and task identities
  • configurable prefixes, task types, and tags
  • task dependencies, milestones, and acceptance criteria
  • lifecycle commands for ready, active, blocked, and completed work
  • human-readable and JSON output
  • a Rust library for applications that need the same task contract

Install

Install the command from crates.io:

cargo install taskroot --locked

Start a task project

Run init at the root of any project:

cd /path/to/your-project
taskroot init --domain work --prefix WORK
taskroot validate

This creates .tasks/config.json. Domain directories are created when you add their first task.

taskroot add \
  --id work:WORK-001 \
  --title "Add project health check" \
  --priority High \
  --type Feature \
  --criterion "The health check reports dependency failures."

taskroot ready
taskroot start work:WORK-001
taskroot criterion-toggle work:WORK-001 0
taskroot done work:WORK-001

Commands discover the nearest ancestor containing .tasks/. Use --root to operate on another project explicitly:

taskroot list --root ../another-project --format json

Use the library

Library callers open an explicit task project. Discovery remains optional so a long-lived process can work with several projects safely.

use taskroot::{project::TaskProject, repo::discover_project_root};

let root = discover_project_root(std::env::current_dir()?)?;
let project = TaskProject::open(root)?;
println!("{}", project.root().display());
# Ok::<(), Box<dyn std::error::Error>>(())

See the task tracking guide for the configuration format and command reference.

Migrate from filer-task

Taskroot retains the .tasks/ project format. Replace the old executable and continue using the same task files:

cargo uninstall filer-task
cargo install taskroot --locked
taskroot validate

Rust consumers should rename the dependency and imports from filer_task to taskroot.

License

Taskroot is available under the MIT License.