Your First Agent

Run a minimal, reviewable agent flow using the legacy CrabCode facts from agents, sessions, and hooks.

Goal

Let CrabCode complete one traceable task inside a project directory, then name, export, or resume the session for review.

Steps

1. Open the target repository and start crabcode.
2. Give one bounded task, for example: “Read the README and tell me how this project runs tests.”
3. For a project-level role, add <repo>/.crabcode/agents/<name>.md, then manage it with /agents.
4. Use /rename for a readable session name and /export for a review transcript.

Boundary

Use Agents for complex task fan-out. Add Hooks only when you need scripted pre/post behavior.