Documentation Navigation
Agents

Custom agents

Define your own agents globally or per project with one markdown file. (Pro)

#Existing agents

AgentRole
PrometheusBuild: implement, edit, and test changes.
AthenaPlan: architect and break work into tasks.
ScoutExplore: read-only codebase reconnaissance.
IrisResearch: delegated research and implementation.
MatisAutopilot: full-app builds from a prompt.
HermesWorkpilot: delegated multi-step office work.

#Define the agent

markdown
---
description: Reviews code changes for performance improvements
mode: subagent
model: anthropic/claude-sonnet-4-5
tools:
  write: false
  bash: false
---

You are a performance optimization expert. Review code inputs for bottlenecks and leaks.
  • description: one line shown in the picker so you trust it before you run it.
  • mode: run the agent as a primary persona or an isolated subagent.
  • model: pin the agent to a specific provider model.
  • tools: disable tool groups per agent; write: false blocks file writes and bash: false blocks shell commands.

#Run the agent

#Mention the agent

bash
@performance check this file

The filename sets the call identifier. Mention @performance in chat to run it against your input.

#Set tool permissions

  • Allow: the tool group runs without prompting.
  • Ask: approve each use when prompted.
  • Deny: block the tool group for this agent entirely.

#See also