pbakaus/impeccable · info

Run `npx impeccable update --user` to refresh them, or remov

Error message

Run `npx impeccable update --user` to refresh them, or remove them so the project agents apply.

What it means

Remediation hint printed immediately after the shadowing warning (error 153) from `report_provider_agents`. It tells the user the exact command to either refresh the shadowing user-level agents (`npx impeccable update --user`) or remove them so the just-installed project agents apply.

Source

Thrown at crates/skills/src/bundle.rs:778

/// JS: reportProviderAgents(results)
pub fn report_provider_agents(sys: &Sys, io: &mut Io, results: &[AgentResult]) {
    for result in results {
        if result.written == 0 {
            continue;
        }
        io.out(&format!(
            "Installed {} agents into: {}\n",
            provider_display_name(result.provider),
            sys.format_path_for_display(&result.dest_dir)
        ));
        if !result.shadowed.is_empty() {
            io.err(&format!(
                "Warning: user-level agents in {} shadow the project copies just installed: {}.\n",
                sys.format_path_for_display(&result.user_dir),
                result.shadowed.join(", ")
            ));
            io.err("Run `npx impeccable update --user` to refresh them, or remove them so the project agents apply.\n");
        }
    }
}

pub struct LinkSource {
    pub checkout_root: String,
    pub bundle_root: String,
}

/// JS: resolveLinkSource(sourceValue, root)
pub fn resolve_link_source(source_value: Option<&str>, root: &str) -> Result<LinkSource, String> {
    let source_path = source_value.unwrap_or(".impeccable");
    let checkout_root = if jsp::is_absolute(source_path) {
        source_path.to_string()
    } else {
        jsp::resolve(root, &[source_path])
    };
    let universal_root = jsp::join(&[&checkout_root, "dist", "universal"]);

View on GitHub (pinned to 2bc2879276)

Solutions

1. Execute the hint: `npx impeccable update --user` to bring user-level agents up to date.
2. Or remove the listed user-level agent files so project agents are used.
3. Re-run the install to verify the warning no longer appears.

When it happens

Trigger: Always emitted together with the 'user-level agents ... shadow the project copies' warning whenever `result.shadowed` is non-empty after an agent install.

Common situations: Same contexts as the shadowing warning: prior `--user` installs, stale home-directory agent copies, dotfiles syncing agents into the user config dir.

Related errors

• Warning: user-level agents in {} shadow the project copies j
• Skipped existing {provider}/skills/{skill}. Use --force to r

AI-assisted analysis of pbakaus/impeccable@2bc2879276 (2026-09-08). Data as JSON: /api/errors/74f6ba6f496de48c. Report an issue: GitHub.