CLI Arguments — Andromity Docs

CLI Reference

Andromity supports multiple CLI flags and command options to facilitate headless or script-based operations.

Global CLI Commands1. Launch TUI (Default)

Opens the rich interactive interface in the current directory:

BASH

andromity
# or explicitly
andromity tui

2. Scripted Instruction Execution

Execute a task directly without entering the full TUI:

BASH

andromity run [instruction] [options]

3. Clear Cache

Clear session cache and index logs:

BASH

andromity cache clear

Command Flags

When running andromity run "task", the following options are supported:

Flag	Shortcut	Description	Default
`--yes`	`-y`	Auto-approves all file changes and shell commands (equivalent to YOLO mode).	`false`
`--dry-run`	`-d`	Preview files modified/created in stdout without writing edits to disk.	`false`
`--model [name]`	`-m`	Override default provider/model configuration.	Config value
`--profile [name]`	`-p`	Select active agent profile (`builder`/`coder`/`reviewer`/`planner`).	`builder`
`--mode [name]`	`-l`	Set initial permission level (`safe`/`trust`/`full`/`yolo`).	`safe`
`--remote`	`-r`	Enable secure Remote Bridge link for the session.	`false`

cli