Skip to main content

Agent Defaults

Account-wide defaults for new Genies. Two levels:

  • General defaults — apply to every new Genie regardless of provider.
  • Per-provider defaults — apply to new Genies of a specific provider (Claude, Gemini, OpenCode, etc.) and override the general default.

The settings cascade for a Genie is: per-Genie → per-provider default → general default → platform default → built-in default. See Genies → Settings cascade.

Configurable fields​

FieldWhat it controls
CLI versionPin a provider CLI version (e.g. v0.12.3). Blank = latest.
Image tagDocker image tag. Blank = provider default.
CPU limitContainer CPU (e.g. 1.5 or 2).
Build in publicDefault visibility on new Genies.
June15 (PTY-wrapped Claude)Route Claude through a PTY-driven TUI wrapper. Feature-parity transparent.
MCP JSONCustom MCP server configuration. Merged with admin defaults.
Custom environmentKEY=VALUE pairs. Highest precedence in the env merge. One per line. Drop a .env file or type.
Agent rulesRules file content (e.g. CLAUDE.md, GEMINI.md). Synced to the agent workspace on every run.
System promptDefault system prompt for new Genies.
Mounted filesFiles auto-mounted into the Genie's workspace.
Post-init scriptRuns once on environment setup.

Content modes​

For text fields that already have an upstream value (per-provider, platform, or built-in default), three modes:

  • Use default — inherit verbatim.
  • Append — extend the upstream value.
  • Override — replace entirely.

Append is the safe default. Override only when the upstream value gets in the way.

Per-provider page​

Click a provider to open its defaults. The page mirrors the general defaults page with the provider's own values. Save propagates to all Genies of that provider that don't override the field per-Genie.

Reset​

Each field has a reset action: drop the account value and fall back to the next level in the cascade.

Last updated on