← Back to catalog tool · taskledger
TaskLedger
Git-native task management CLI for humans and coding agents, backed by Markdown files and an append-only event log.
- ID
- taskledger
- Kind
- tool
- Owner
- aholbreich
- Lifecycle
- production
- Tier
- 1
- System
- developer-tools
- Domain
- engineering-productivity
- Platform
- github
Tech stack
- Languages
- go
- Data
- markdownjsonlgit
- Runtime
- local-cli
- Tooling
- gogithub-actionshomebrew
Documentation
TaskLedger
TaskLedger (tl) coordinates work between humans and AI coding agents inside a repository. It stores tasks as Markdown, records changes in an append-only journal, and supports dependency-aware ready queues plus lease-based task claims.
Responsibilities
- create, list, claim, release, and close repository-local tasks
- preserve task history in Git-friendly files
- prevent accidental multi-agent overlap with claim leases
- keep task coordination local without a daemon or external database
Architecture
flowchart LR
Human[Human] --> TL[tl CLI]
Agent[Coding agent] --> TL
TL --> Tasks[Markdown task files]
TL --> Events[events.jsonl journal]
Tasks --> Git[Repository history]
Events --> Git
Source
This entry was generated from the public, non-fork GitHub repository metadata and README content available under aholbreich.
Operations
- Runbook:
Open runbook ↗ - GitHub Actions:
Open pipeline ↗ - GitHub repository:
Visit ↗ - Issues:
Visit ↗
Dependencies
No dependencies declared.
Quality
No validation issues.