Tools guide
Amistio owns the agent loop
Amistio coordinates work and the local runner executes it through the built-in Amistio direct agent. External coding-agent harnesses and custom local commands are not runner execution routes.
The tool model
The runner uses Amistio-owned prompts, bounded filesystem/Git/package/test/browser tools, and direct provider access. The web app stores safe readiness and evidence metadata, while provider tokens and repository execution stay on the runner machine.
Your provider tokens, source checkout, package manager credentials, shell profile, and machine-specific setup stay on your machine. The web app should only need safe status and reviewable project-brain records.
Supported choices
auto
Use the Amistio direct route when a supported direct provider is configured for the runner.
Amistio direct
Use the built-in Amistio direct agent with bounded local tools and direct providers.
Runner setup checklist
- Install the Amistio CLI runner and confirm `amistio --help` works.
- Set a provider token such as `GITHUB_MODELS_TOKEN`, `GITHUB_TOKEN`, `OPENAI_API_KEY`, or `ANTHROPIC_API_KEY` locally for the runner.
- Run `amistio tools` to confirm the built-in Amistio direct capability.
- Pair or import the repository so work is scoped to the correct project.
- Use runner lifecycle controls only for runners you paired, unless you are acting as an organization admin.
- Choose the direct provider/model in the app or runner preferences.
- Use approved verification profiles instead of arbitrary shell or external harness commands.
No external harness escape hatch
Amistio no longer exposes external coding-agent harnesses, SDK bridges, CLI tools, or arbitrary custom commands as runner execution routes. New tool capability should be added as typed Amistio-owned bounded tools.
Good fit
A typed tool adapter with repository-relative inputs, policy validation, redaction, output budgets, and evidence summaries.
Out of scope
A third-party agent session, broad shell command, hidden provider transcript, or custom local wrapper that Amistio cannot audit end to end.
How tools connect to the project brain
The project brain gives the Amistio direct agent better starting context: ADRs explain why, plans explain sequence, feature specs explain behavior, prompts describe the work unit, memory captures lessons, and workflows keep repeated operations consistent. The agent is the executor; the brain is the durable operating layer around it.