Metadata-Version: 2.5
Name: agent-pmo
Version: 0.1.0
Summary: Project management for AI coding agents: specs, decisions, tests, reviews and releases with traceable evidence.
Project-URL: Homepage, https://github.com/vksbhandary/agent-pmo
Project-URL: Changelog, https://github.com/vksbhandary/agent-pmo/blob/master/CHANGELOG.md
Author: Vikas Bhandary
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,claude,codex,project-management,specs,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# agent-pmo — project management for AI coding agents

agent-pmo is a small command-line tool that lets coding agents (Claude Code, Codex, Gemini CLI, Copilot, Cursor, …) build a project the way a careful team would:

- **Plan first, never guess.** Every open question is asked, and every answer is kept word for word as a decision.
- **Work from specs.** Each component has a spec with requirements and a plan of small, testable increments.
- **Prove each step.** Code is tested against its requirements, scanned for security issues, and reviewed by a *different* model.
- **Keep you in charge.** Agents work in parallel and never wait. You review every unit in its own pull request, and `stable` only ever holds code that passed everything.
- **Trace everything.** Every commit, report, issue and decision links back to the change and the requirement it belongs to.

It works with any language, on Linux, macOS and Windows, with GitHub, GitLab, Bitbucket or no hosting at all. It needs Python 3.11+ and git, and has no dependencies of its own.

## Set up

```bash
pipx install agent-pmo                       # or: uv tool install agent-pmo
agent-pmo install --agents claude,agents     # in your repository: the agents' instructions and entry files
```

`install` writes the agents' instructions into `.pm/` and an entry file for each coding agent (`CLAUDE.md`, `AGENTS.md`; also `gemini`, `copilot`, `cursor`). Commit them with your project.

Then open your coding agent in the repository and say one of:

| | Say |
|---|---|
| New project | **"set up the project"** |
| Existing code | **"analyse old code"** |
| Idea in an issue | **"plan the project from issue #12"** |
| Quick experiment | **"build `<idea>` quickly"** |

The agent asks you everything it needs (what you're building, how you work, the coding style, your git provider) and sets up the rest. If you work with a git provider, give the agents their own token: `AGENT_TOKEN=<token>` in `.env`.

## Day to day

Talk to your agent: **"status"**, **"continue"**, **"test the next spec"**, **"review the next spec"**, **"fix `<bug>`"**, **"fetch repo issues"**, **"plan the deployment"**, **"revert `<change>`"**. You review and merge the review pull requests; CI does the rest.

## Learn more

| | |
|---|---|
| [Getting started](docs/getting-started.md) | setup paths and the daily loop, in more detail |
| [Commands](docs/commands.md) | every `agent-pmo` command with examples |
| [Configuration](docs/configuration.md) | `pm.toml`, table by table |
| [Concepts](docs/concepts.md) | units, statuses, the branch model, reviews, decisions, traceability |
| [Automation](docs/automation.md) | hooks, CI, scheduled checks, providers and tokens |
| [Development](docs/development.md) | the code map, tests, adding a language |
| [WORKFLOW.md](WORKFLOW.md) | the process the agents follow (with one file per workflow in [workflows/](workflows/)) |

## Updating

Each project pins its version (`[kit] version` in `pm.toml`), so hooks, CI and the whole team run the same one. After `pipx upgrade agent-pmo`, run **`agent-pmo upgrade`** in the project: it migrates it, refreshes `.pm/`, the entry files, hooks and CI, and pins the new version. `agent-pmo version --check` shows what's installed, pinned and latest; [CHANGELOG.md](CHANGELOG.md) lists every release.
