pinto

Clarity, Simplicity and Humanity.
With or without AI.

pinto is a lightweight, local-first Scrum backlog and Kanban board for the terminal. It keeps Product Backlog Items (PBIs), Sprints, and workflow state in plain text so that every change is easy to inspect and recover with Git.

Principles

• Lightweight and focused. pinto keeps a small Scrum vocabulary instead of becoming a general project-management suite.
• Plain text and Git-friendly. The file and Git backends keep board data readable; SQLite is an optional normalized local backend.
• Local first. No server, database service, or account is required.

Installation

The latest published release is 0.4.2. Install it from crates.io:

cargo install pinto-cli --version 0.4.2
pinto --version

To install from a checkout, use the committed lockfile:

git clone https://github.com/moriturus/pinto
cd pinto
cargo install --path . --locked
pinto --version

Quick start

Run these commands from the directory that should own the board:

pinto init
pinto add "Implement the Markdown parser" --points 3 --label backend
pinto list
pinto move T-1 in-progress
pinto board

For the complete first-workflow walkthrough, see Quick start.

Documentation

The published Book is the primary user and contributor guide. Build it locally with mise install && mise run book or preview it with mdbook serve.

User guide

• Introduction
• Installation
• Quick start
• CLI reference
• Configuration
• Data format
• Kanban (TUI)
• Cookbook
• Team-scale best practices
• Contributing
• Testing and fuzzing
• Local CI
• Reproducibility
• Undoing a mutation
• Merging shared boards
• Dogfooding

Repository references

• Design decisions
• JSON output
• Storage migration
• Stability decisions
• Dependency decisions
• External command contract
• Agent skills
• Benchmarks

The published Book is deployed from main, develop, and release tags by pages.yml. The site root redirects to /latest/; the development Book is under /develop/, and versioned Books are available under /<version>/.

Development

Read CONTRIBUTING.md and AGENTS.base.md before changing the project. The standard local gate is:

mise install
mise run check

See Reproduce CI locally for platform-specific act commands.

License

Released under the MIT License.