Metadata-Version: 2.4
Name: cotterpin
Version: 0.0.1
Summary: Proof-gated harness for AI coding agents — mechanical gates, local-first, evidence-backed
Author: Mark Clarke
Project-URL: Homepage, https://cotterpin.io
Project-URL: Source, https://github.com/cotterpinhq
Keywords: ai,agents,coding-agent,verification,gates,governance,claude-code,codex,gemini,grok
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Cotterpin

**Proof-gated automation for AI coding agents.**

A cotter pin is the small part whose only job is to stop something falling apart while it
moves. Cotterpin does that for coding agents: it runs them against mechanical gates, so a task
counts as done only when evidence says so — not when the agent says so.

## Status: name reservation

This 0.0.1 release reserves the name and installs nothing useful. There is no working release
yet. Follow <https://cotterpin.io> for progress.

## What it will do

- **Run agents against gates that can refuse.** Claude Code, Codex, Grok and Gemini, behind
  one task model.
- **Catch what linters cannot** — an agent that runs the tests, sees them pass, and reports
  work as delivered that was never wired up.
- **Prove it.** Every verdict is backed by a receipt bound to the exact inputs it checked,
  chained so the history cannot be quietly rewritten.
- **Keep your code local.** Source, diffs and prompts stay on your machine; only your chosen
  model provider ever sees your code, under your own account.

## Intended usage

```sh
pipx install cotterpin

cotterpin install     # user-space runtime, no admin
cotterpin connect     # detect and check your provider CLIs
cotterpin init        # write policy, pin the gate pack, dry-run the gates
cotterpin run <task>  # run the work, gated
```

## Licence

All rights reserved pending a licence decision.
