Settings

Accessing Settings

Click the Settings icon in the UI or access via the in-game menu.

Game Tab

Setting	Description
Agent Teams	Toggle team display for Claude Code team configurations
Default Agent Model	Model for spawned heroes (see below)
Usage Analytics	Toggle anonymous analytics
Open in IDE	Choose a preferred detected editor for file paths and diffs
Team Banners	Customize team colors and banner icons

Default Agent Model

Controls the --model flag when spawning heroes:

Option	Behavior
Default	No `--model` flag (recommended for Bedrock/Vertex)
Opus	`--model opus`
Sonnet	`--model sonnet`
Haiku	`--model haiku`
Custom...	Any model string (e.g., `ollama:llama3`)

You can also override the model per hero using the model dropdown at the top of the side panel.

About Tab

Shows version info, detected CLI versions, provider info, and links to:

Privacy policy
Website, Twitter, Discord
Hall of Glory (Achievements) button — opens the achievement gallery

Configuration Files

All AgentCraft config lives in ~/.agentcraft/:

File	Purpose
`config.json`	Port, autoOpenBrowser, API keys
`auth.json`	Auth tokens (0o600 permissions)
`server.pid`	PID of daemon-mode server
`mission-history.json`	Persisted completed missions
`settings.json`	UI preferences, dispatch configuration, and provider settings
`logs/server-<port>.log`	Retained foreground and daemon server output
`task-queue.json`	Persisted Campaign plans and tasks
`plan-memory/`	Campaign workpads, verification reports, and evidence

Restore Settings

To undo a completed AgentCraft uninstall, restore its automatic backup manifest:

npx @idosal/agentcraft restore

Use restore --list to see all backup sessions or restore --from <path> to choose one. The restore can replay every file and directory recorded by uninstall, not just Claude settings.