Skip to content

Maximum-union configuration

UltraCode treats opencode.json(c) as a user-owned document rather than a replaceable template.

  • Add missing object keys recursively.
  • Append missing array entries with deduplication.
  • Preserve conflicting scalar values and report them.
  • Keep comments, providers, credential references, and unknown fields.
  • Never replace an existing default_agent silently.
  • Leave unrelated MCP servers, skills, and agents outside the ownership manifest.

Roles live under agents/ultracode/, commands under commands/ultracode/, and the managed MCP server is named ultracode_playwright. This reduces collisions with existing definitions.

{
// My preferred primary agent
"default_agent": "my-agent"
}

The installer keeps my-agent, reports the conflict, and still makes UltraCode roles available for explicit use.

Hashes in the install manifest distinguish an older managed version from a user-edited file. Locally edited agents survive later apply and uninstall operations.

Original files are backed up before actual writes. For recovery, uninstall first, then inspect timestamped backups. Do not blindly overwrite changes made after that backup.