yirifi-roadmap

CLI and TUI for the yirifi-roadmap planning system. Handles all mechanical operations (ID generation, status transitions, schema validation, progress computation, dependency graphs) so Claude can focus on intelligence.

Installation

From PyPI

# CLI only
uv pip install yirifi-roadmap

# CLI + Terminal UI
uv pip install "yirifi-roadmap[tui]"

From Source (development)

cd yirifi-roadmap-app

# CLI only
uv pip install -e .

# CLI + TUI
uv pip install -e ".[tui]"

# With dev dependencies (testing)
uv pip install -e ".[tui,dev]"

Usage

CLI

yirifi-roadmap --help

# Query commands
yirifi-roadmap query status          # Items grouped by status
yirifi-roadmap query backlog         # Approved items by priority
yirifi-roadmap query blocked         # Blocked items + blockers
yirifi-roadmap query assigned saurav # Items for a person
yirifi-roadmap query progress        # Progress aggregation

# Compute commands
yirifi-roadmap compute stats         # Roadmap-wide statistics
yirifi-roadmap compute graph         # Dependency graph + bottlenecks
yirifi-roadmap compute impact feat-x # What does completing this unblock?
yirifi-roadmap compute stale         # Items not updated in 30+ days

# Validate commands
yirifi-roadmap validate audit        # Full repo health check

All commands output JSON by default. Add --human for formatted text.

TUI

yirifi-roadmap-tui

5 tabs: Dashboard, Items, Board (kanban), Timeline, Dependencies.

Keyboard shortcuts: 1-5 switch tabs, r refresh, n new item, q quit, Enter open detail, t transition, c check tasks, Esc close modal.

Without Installing

cd yirifi-roadmap-app

# CLI
python -m yirifi_roadmap.cli --help

# TUI
python -m yirifi_roadmap.tui

Command Groups

See CLI Reference for the full command list.

Publishing

./scripts/publish-pypi.sh              # Interactive mode
./scripts/publish-pypi.sh --bump patch # Bump and publish
./scripts/publish-pypi.sh --dry-run    # Build only, no upload
./scripts/publish-pypi.sh --help       # All options

Documentation

• Onboarding Guide — Getting started
• Architecture Overview — Two-layer design
• CLI Reference — All 45 commands
• Slash Commands — Claude Code integration