zeroclaw-labs/zeroclaw · error

cli-alias-create-reserved-default

cli-alias-create-reserved-default

Error message

the `default` agent is reserved and cannot be created

What it means

Error "the `default` agent is reserved and cannot be created" thrown in zeroclaw-labs/zeroclaw.

Source

Thrown at src/alias_cli/mod.rs:110

            "{}",
            mta(
                "cli-alias-no-such-section",
                &[("section", section)],
                "no such config section: {$section}"
            )
        ),
    }
    Ok(())
}

fn create_entry(config: &mut Config, section: &str, alias: &str) -> Result<()> {
    // Shared guarded boundary: refuses the reserved `default` agent here too (an
    // operator create surface), and delegates unchanged for every other section.
    // The Reserved rejection is localized via Fluent like the delete/rename guards
    // below; Invalid (unknown section) keeps its pre-existing bare error.
    let created = match alias_refs::create_map_key_checked(config, section, alias) {
        Ok(created) => created,
        Err(alias_refs::CreateError::Reserved(_)) => bail!(
            "{}",
            mt(
                "cli-alias-create-reserved-default",
                "the `default` agent is reserved and cannot be created"
            )
        ),
        Err(alias_refs::CreateError::Invalid(msg)) => return Err(anyhow::Error::msg(msg)),
    };
    if created {
        config.mark_dirty(&format!("{section}.{alias}"));
        println!(
            "{}",
            mta(
                "cli-alias-created",
                &[("section", section), ("alias", alias)],
                "created {$section}.{$alias}"
            )
        );

View on GitHub (pinned to 88bb9c8533)

Solutions

1. Choose a different agent name; `default` is reserved for the built-in agent.
2. Configure the built-in default agent instead of creating a new one with that name.

When it happens

Trigger: Thrown at src/alias_cli/mod.rs:110 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/49d45322630f174a. Report an issue: GitHub.