taskgraph 0.1.0

CLI tool for managing task dependencies using markdown files
Documentation

TaskGraph

A CLI tool for managing task dependencies using markdown files.

Each task is a single .md file with YAML frontmatter, making tasks version-controllable, LLM-editable, and naturally concurrent.

Installation

cargo install taskgraph

Quick Start

# Initialize a new task
taskgraph init my-task --name "My Task"

# List all tasks
taskgraph list

# Validate task files
taskgraph validate

# Show topological order
taskgraph topo

# Check for circular dependencies
taskgraph cycles

# Show parallel work groups
taskgraph parallel

Task File Format

---
id: my-task
name: My Task
status: pending
depends_on: [other-task]
scope: narrow
risk: low
---

Detailed description of the task goes here.

Required Fields

Field Type Description
id string Unique identifier
name string Human-readable name

Optional Fields

Field Type Description
status enum pending, in-progress, completed, failed, blocked
depends_on string[] Tasks that must complete first
scope enum single, narrow, moderate, broad, system
risk enum trivial, low, medium, high, critical
impact enum isolated, component, phase, project
level enum planning, decomposition, implementation, review, research
tags string[] Arbitrary tags for filtering

Commands

Task Management

Command Description
init <id> Scaffold a new task file
validate Validate all task files
list List all tasks
show <id> Show task details

Graph Operations

Command Description
deps <id> Show what a task depends on
dependents <id> Show what depends on a task
topo Show topological order
cycles Check for circular dependencies
parallel Show parallel work groups
critical Show critical path
bottleneck Show bottleneck tasks
graph Output graph in DOT format

Workflow Analysis

Command Description
risk Show risk distribution across tasks
decompose Flag tasks that should be split
workflow-cost Calculate relative workflow cost
risk-path Find path with highest cumulative risk

Project Structure

project/
└── tasks/
    ├── task-one.md
    ├── task-two.md
    └── ...

Learn More

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.