Quickstart

Install. Run. Resume. Write your first AGENTS.md. Ten minutes.

Install

One binary on your PATH. macOS and Linux.

bun install -g @phnx-labs/agents-cli
agents --help

Run your first agent

No project config required. Run it inside any repo — the agent reads the files it needs and writes nothing you have not approved.

agents run claude "list the files in this repo and tell me what each one does"

The run streams to your terminal and lands in the session log on disk.

Resume what the agent did

Every run is captured. Pick one from the interactive list, or dump it as markdown to read back the full transcript.

agents sessions
agents sessions <id> --markdown

Write your first AGENTS.md

AGENTS.md at the repo root is the harness's instructions. The agent reads it on every run. Start with four lines that capture rules you would otherwise have to repeat in chat.

# AGENTS.md

- Tests live next to source. No mocking.
- Use bun, not npm or yarn.
- Python: built-in type hints, loguru for logging.
- Env files: .env.dev and .env.prod. Never commit either.

When the agent gets it wrong

Do not argue with the agent in chat. Edit AGENTS.md so the next run starts with the rule in context. One failure, one line. That is the loop.

Read harness engineering next for the full pattern.