Agents & Profiles

Andromity operates using distinct Profiles tailored for different stages of your development workflow. You can switch profiles at any time depending on the task.

Available Profiles

Profile	Focus Area	Safe Mode Defaults	Description
`builder` (default)	Development & Planning	High Approval	Full loop: reads code, designs a plan, asks for approval, edits files, runs tests, and reviews diffs.
`coder`	Direct Implementation	High Approval	Skips the planning phase and immediately edits files to perform quick fixes or refactors.
`reviewer`	Auditing & Review	Read-Only (No Shell)	Read-only agent. Scans files, structures, or dependencies to produce a findings report (HIGH/MED/LOW bugs).
`planner`	System Architecture	Read-Only	Read-only agent. Researches the codebase and outputs a Markdown architecture plan without changing files.

Switching Profiles

You can switch profiles dynamically using the TUI shortcut, chat commands, or CLI flags.

1. Keyboard Shortcut (TUI)

Press Ctrl+J in the TUI to open the Profile Picker menu, then select your desired profile using arrow keys.

2. Chat Command (TUI)

Type directly into the TUI input bar:

BASH

/profile coder
/profile reviewer

3. CLI Argument (Headless)

When invoking a scripted run, pass the --profile flag:

BASH

andromity run "audit security of auth.py" --profile reviewer

agents