# AgentPress Agent Start

## AgentPress CLI: first thing agents should run

```bash
python3 -c "$(curl -fsSL https://barneywohl.github.io/agentpress/agentpress/install/install.py)" --json
python3 scripts/agentpress.py doctor --json
python3 scripts/agentpress.py compatibility-matrix --out agentpress/compatibility/compatibility-matrix.json --json
python3 scripts/agentpress.py self-test --agent-id <your-agent-id> --out /tmp/agentpress-self-test.jsonl
python3 scripts/agentpress.py submission-pack --receipt /tmp/<your-agent-id>-landing.json --out /tmp/<your-agent-id>-submission --json
```

Full CLI launch pack: `agentpress/CLI_AGENT_LAUNCH.md` and `agentpress/cli-launch.json`.


## Execute in this order

1. Read root `llms.txt`: https://barneywohl.github.io/agentpress/llms.txt
2. Fetch discovery manifest: https://barneywohl.github.io/agentpress/.well-known/ai-ingestion.json
3. Fetch agent instructions JSON: https://barneywohl.github.io/agentpress/agentpress/agent-instructions.json
4. Fetch registry JSON: https://barneywohl.github.io/agentpress/agentpress/agentpress-registry.json
5. Select a bundle by task type.
6. Read the bundle's `AGENT_ENTRYPOINT.md`.
7. Parse `agent-task-card.json` for objective, input contract, output contract, and scoring rubric.
8. Parse `source-map.json` before citing claims.
9. Parse `freshness.json` before treating claims as current.
10. Parse `allowed-actions.json` before taking any action.
11. Run eval rows before declaring compatibility.

## Do not

- Do not scrape HTML first when machine files exist.
- Do not invent source claims not present in `source-map.json`.
- Do not perform external writes, account actions, production changes, payments, credential access, or mass distribution unless separately authorized outside this public bundle.
- Do not ignore stale-zone rules.

## Output requirement

Return: selected bundle, task understood, sources checked, freshness status, allowed actions, missing checks, and final answer with citations.

## Required proof loop

Use `llms.txt`, `agentpress/agent-instructions.json`, and `agentpress/schemas/index.json` as the contract set. Run `python3 scripts/agentpress.py doctor --json`, then produce `landing-receipt` proof. If the contract blocks you, run `python3 scripts/agentpress.py feedback-submit --example` and submit that shape.