YYLO Ledger (GitHub) is an open-source, Git-native task manager and Record store for developers, automation tools, and AI coding-agent workflows. It provides a shell-friendly CLI for creating tasks, tracking dependencies, recording progress, preserving history, and querying project work without making a hosted database the source of truth.
Ledger keeps canonical current state in reviewable Markdown files inside the repository and records opt-in history in segmented, hash-chained ledgers. A disposable SQLite cache accelerates broader queries but can be rebuilt from the canonical files. This design makes project tasks easier to review, version, audit, and coordinate alongside source code.
YYLO Ledger is part of the wider YYLO developer-tool ecosystem. Use it independently as a Git-based task management CLI, connect it with YYLO CLI (GitHub) for AI coding-agent orchestration and guarded software delivery, or pair it with YYLO Benchmark (GitHub) for evaluation and evidence workflows.
Product page: YYLO Ledger on yylo.dev
Source code: YYLO Ledger on GitHub
Python package: yylo-ledger on PyPI
AI agent orchestration: YYLO CLI on yylo.dev · GitHub · npm
Evaluation tooling: YYLO Benchmark on yylo.dev · GitHub · npm
Use Cases
- Local read integrations: Expose bounded, read-only Record projections to approved local applications and developer utilities.
- AI-assisted software delivery: Combine Ledger with YYLO CLI to connect task records with dedicated worktrees, validation evidence, and guarded merge workflows.
YYLO Ledger serves as the foundational engineering memory for development teams, providing a local, dependency-aware source of truth for all task-related information. It is designed to make engineering work transparent and legible for both human collaborators and autonomous coding agents.
Key features of YYLO Ledger include:
- Durable Task Truth: All task bodies, statuses, responses, tags, relationships, and crucial commit evidence are stored directly within Git, ensuring a robust and version-controlled record. This Git-native approach guarantees data integrity and traceability.
- Dependency Awareness: The system allows for the modeling of task blockers and dependencies, enabling teams to easily identify ready-to-work tasks and topologically order them for efficient dispatch. This ensures a logical flow of work and prevents bottlenecks.
- Agent-Friendly Output: YYLO Ledger provides flexible output formats such as JSON, NDJSON, XML, and tables. This versatility makes it ideal for integration with scripts, automated agents, and human operators, facilitating seamless communication and automation within the development workflow.
- Retained History: Every mutation and change to a task is preserved, maintaining a complete history. Once tasks are completed, they can be moved into immutable cold archive packs, ensuring that valuable historical data is never lost and remains accessible for auditing or future reference.
To get started, users can install the synchronized release via pip:
pip install yylo-ledger==0.2.1rc1And begin by creating a task:
yy ledger create "Verify the release" --status todo
