CoDev

Human-guided AI software delivery.

CoDev installs a small, production-minded collaboration system into any Git repository. A developer and AI move through four steps — Understand, Build, Review, Ship — plus two that only show up when the work actually needs them: Specify for a genuinely new product, Launch for a real rollout decision. Review is layered, not a single pass: a fast correctness check after each build, an automatic style and maintainability gate immediately before a pull request opens, and five parallel specialist reviewers once it's open. It supports bounded three-agent execution without turning product development into an unattended coding loop.

Why CoDev

• One workflow for solo developers and multi-developer teams.
• Repository-grounded plans instead of invented APIs or architecture.
• A bounded builder, an automatic pre-PR audit gate, and five parallel specialist reviewers — not just one read-only pass.
• Human authority over material decisions, merge, deployment, and rollout.
• A general-purpose skill-evaluation harness — measure whether a skill (CoDev's own, or one you wrote) actually helps, empirically, rather than just trusting that it does.
• Versioned, conflict-aware installation across existing repositories.
• No runtime dependency in the software being built.

Try it in 60 seconds

pipx install open-codev-workflow
# or: uv tool install open-codev-workflow

codev init --target . --agent-platform all
codev status --target .

CoDev 0.4.0 - /path/to/your/repo
Bundle: healthy (76 managed files, no drift)
Adapters: opencode
Tasks in progress: 0

Commit the installed files as one infrastructure change, then start an AI session in the repository and describe a small bug or task in plain language — you don't need to name a skill. Tutorial 1 walks one small fix from here to a merged pull request, with every command and real output shown.

Where to go next

Design principles

1. Local at use time. Agents read ordinary files in the target repository.
2. Central at maintenance time. This repository is the canonical source.
3. Human at authority boundaries. Automation supplies evidence, not approval.
4. Small by default. Deeper design and delivery planning appear only when risk or coordination requires them.
5. Safe to adopt. Existing instructions and OpenCode settings are preserved.

Development

python -m unittest discover -s tests -v
python -m compileall -q src tests
python -m codev_workflow --version

Optional development checks:

python -m ruff check .
python -m ruff format --check .
python -m mypy
python -m build
python scripts/check_bundled_doc_links.py

See CONTRIBUTING.md for what's expected of a change, and docs/releasing.md for the release process.

CoDev is licensed under BSD-3-Clause.