# roadkeep

Docs · CLI · Agent Workbench

A ROADMAP and a CHANGELOG are formats held together by convention, so they drift the moment someone is in a hurry — or the moment an agent writes to them. roadkeep owns the writes: an entry goes in through a command that checks its shape at the point of insertion, which makes the file a schema rather than a habit. Its desktop app reads every backlog on the machine at once.

- Platform: Python ≥3.11
- Licence: Apache-2.0
- Product site: https://alegauss.com/roadkeep/
- Documentation: https://alegauss.com/roadkeep/docs/
- Source: https://github.com/alegauss/roadkeep

Public numbers as of 2026-11-13: latest release v0.2.576 (2026-11-09); 204 PyPI downloads in the last 30 days.

## Install

Claude Code plugin:

```
/plugin marketplace add alegauss/alegauss.github.io
/plugin install roadkeep@alegauss
```

uvx:

```
uvx roadkeep lint
```

pip:

```
pip install roadkeep
```

## What comes next

From docs/ROADMAP.md at dd41f01.

### Block M — Codex integration (one engine, host-specific adapters)

- ⏳ No end-to-end evidence shows Roadkeep enforcement inside Codex
- 📋 Users have no verified Codex adoption or distribution guide

## Recently shipped

- 2026-11-12 · RK1750: two branches that each added a block of their own are refused as prose both sides moved
- 2026-11-12 · RK1749: syncing main into a feature is refused when main shipped a line the feature waits on
- 2026-11-12 · RK1748: the renumber the merge driver names derives a destination the other branch already spent
- 2026-11-12 · RK1747: the prose merge refuses two branches that each shipped a decision
- 2026-11-12 · RK1746: declare leaves a new governed file out of a merge driver the project already wired
- 2026-11-12 · RK1745: the prose merge refuses or misplaces sections when one branch added a block
- 2026-11-12 · RK1744: no tested strategy keeps one backlog consistent across parallel long-lived branches
- 2026-11-12 · RK1743: merge refuses a branch that adds a block while the other only files lines under an existing one

All entries: https://alegauss.com/changelog/roadkeep/