{"record":{"id":"74f6ba6f496de48c","repo":"pbakaus/impeccable","slug":"run-npx-impeccable-update-user-to-refresh-them","errorCode":null,"errorMessage":"Run `npx impeccable update --user` to refresh them, or remove them so the project agents apply.\n","messagePattern":"Run `npx impeccable update --user` to refresh them, or remove them so the project agents apply\\.\n","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"crates/skills/src/bundle.rs","lineNumber":778,"sourceCode":"\n/// JS: reportProviderAgents(results)\npub fn report_provider_agents(sys: &Sys, io: &mut Io, results: &[AgentResult]) {\n    for result in results {\n        if result.written == 0 {\n            continue;\n        }\n        io.out(&format!(\n            \"Installed {} agents into: {}\\n\",\n            provider_display_name(result.provider),\n            sys.format_path_for_display(&result.dest_dir)\n        ));\n        if !result.shadowed.is_empty() {\n            io.err(&format!(\n                \"Warning: user-level agents in {} shadow the project copies just installed: {}.\\n\",\n                sys.format_path_for_display(&result.user_dir),\n                result.shadowed.join(\", \")\n            ));\n            io.err(\"Run `npx impeccable update --user` to refresh them, or remove them so the project agents apply.\\n\");\n        }\n    }\n}\n\npub struct LinkSource {\n    pub checkout_root: String,\n    pub bundle_root: String,\n}\n\n/// JS: resolveLinkSource(sourceValue, root)\npub fn resolve_link_source(source_value: Option<&str>, root: &str) -> Result<LinkSource, String> {\n    let source_path = source_value.unwrap_or(\".impeccable\");\n    let checkout_root = if jsp::is_absolute(source_path) {\n        source_path.to_string()\n    } else {\n        jsp::resolve(root, &[source_path])\n    };\n    let universal_root = jsp::join(&[&checkout_root, \"dist\", \"universal\"]);","sourceCodeStart":760,"sourceCodeEnd":796,"githubUrl":"https://github.com/pbakaus/impeccable/blob/2bc2879276c1f321a53c4ca99d3371e411329b52/crates/skills/src/bundle.rs#L760-L796","documentation":"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.","triggerScenarios":"Always emitted together with the 'user-level agents ... shadow the project copies' warning whenever `result.shadowed` is non-empty after an agent install.","commonSituations":"Same contexts as the shadowing warning: prior `--user` installs, stale home-directory agent copies, dotfiles syncing agents into the user config dir.","solutions":["Execute the hint: `npx impeccable update --user` to bring user-level agents up to date.","Or remove the listed user-level agent files so project agents are used.","Re-run the install to verify the warning no longer appears."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Act on the shadowing warning immediately: update --user or remove the user-level copies.","Keep user-level agents refreshed with the same cadence as project installs."],"tags":["installation","agents","remediation-hint"],"backgroundTag":"agent-path-shadowing","analyzedSha":"2bc2879276c1f321a53c4ca99d3371e411329b52","analyzedAt":"2026-09-08T04:51:14.109Z","contentChangedAt":"2026-09-08T04:51:14.109Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}