The field guide
From install
to understanding.
Start with a small, trusted PR and a local model. These guides describe what you can run today and where the project is heading.
One binary for macOS or Linux. Choose the components you need.
First reviewSee an example, connect a model, and review a real pull request.
GitHub connectionGive Ferretta its own identity with a dedicated GitHub App.
ConfigurationUnderstand the current JSON policy and the planned configuration layers.
Background serviceRun PR intake under launchd or systemd with durable local state.
Proposal sessionsAsk intent questions through the GitHub App and resume after human replies.
ArchitectureThe decisions behind intent, orchestration, resource limits, and recovery.
Reviews and scorecardsRun a scoped PR watcher with starting, verdict, and automated scorecard comments.
Review and evaluation planRole-specific grading, resource accounting, and automatic PR milestone comments.