{"record":{"id":"e3342b361b85368a","repo":"pbakaus/impeccable","slug":"init-is-not-a-cli-command-type-impeccable-init","errorCode":null,"errorMessage":"\"init\" is not a CLI command. Type /impeccable init in your AI coding agent's chat (Claude Code, Cursor, Codex, ...), not in this terminal.\n","messagePattern":"\"init\" is not a CLI command\\. Type /impeccable init in your AI coding agent's chat \\(Claude Code, Cursor, Codex, \\.\\.\\.\\), not in this terminal\\.\n","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/cli/src/main.rs","lineNumber":97,"sourceCode":"            let organic = |html: &str| -> Vec<(Option<String>, String)> {\n                impeccable_core::checks::css_scan::scan_css_text_for_organic_clip_path(html)\n                    .into_iter()\n                    .map(|f| (f.selector, f.snippet))\n                    .collect()\n            };\n            impeccable_comp_verbs::run_build_phase(rest, io, &organic)\n        }\n        \"hook\" => impeccable_hook::run_hook(rest, io, engines().html),\n        \"hook-before-edit\" => impeccable_hook::run_hook_before_edit(rest, io, engines().html),\n        \"hooks\" | \"hook-admin\" => impeccable_hook::run_hook_admin(rest, io),\n        v if v.starts_with(\"live\") => impeccable_live::run(v, rest, io),\n        // `npx impeccable src/` shorthand: a path-shaped, flag, URL, or existing\n        // first arg is a detect target (cli.js looksLikeDetectTarget).\n        v if impeccable_detect::looks_like_detect_target(v, &io.cwd.to_string_lossy()) => {\n            impeccable_detect::run_detect(args, io, &engines())\n        }\n        \"init\" => {\n            io.err(impeccable_detect::INIT_MESSAGE);\n            1\n        }\n        other => {\n            io.err(&format!(\n                \"Unknown command: \\\"{other}\\\"\\n\\nTo see a list of supported commands, run:\\n  impeccable --help\\n\"\n            ));\n            1\n        }\n    }\n}\n\n/// The npm `impeccable` package version `cli.js --version` prints (its\n/// `package.json`), tracked separately from the crate version.\npub const CLI_VERSION: &str = \"4.0.0\";\n\n/// The engines wired into `impeccable detect`: the static HTML engine\n/// (crates/html). The browser engine (crates/browser) plugs in here once it\n/// lands; until then URL scans report the puppeteer message.","sourceCodeStart":79,"sourceCodeEnd":115,"githubUrl":"https://github.com/pbakaus/impeccable/blob/2bc2879276c1f321a53c4ca99d3371e411329b52/crates/cli/src/main.rs#L79-L115","documentation":"The impeccable CLI does not implement 'init' as a terminal command; initialization is an agent-chat skill verb. Running `impeccable init` in a shell hits this arm of run() in main.rs, prints the INIT_MESSAGE telling the user to type `/impeccable init` inside their AI coding agent (Claude Code, Cursor, Codex, ...), and exits with code 1.","triggerScenarios":"Executing `impeccable init` (or any argv where the first arg is literally \"init\") in a terminal; the match in run() routes \"init\" to io.err(INIT_MESSAGE) and returns 1.","commonSituations":"Users migrating from other CLIs where `init` is a normal setup subcommand; copy-pasting the agent-chat instruction `/impeccable init` as a shell command but dropping the slash; skimming docs and assuming init configures the terminal tool.","solutions":["Run `/impeccable init` in your AI coding agent's chat (Claude Code, Cursor, Codex, ...) instead of the terminal","Run `impeccable --help` to see the commands the terminal CLI actually supports","If you meant project setup, open your agent chat and invoke the impeccable skill's init verb there"],"exampleFix":"// before (terminal)\n$ impeccable init\n// after (agent chat)\n/impeccable init","handlingStrategy":"validation","validationCode":"if [ \"$1\" = \"init\" ]; then echo 'Run /impeccable init in your AI coding agent chat, not the terminal'; exit 1; fi","typeGuard":null,"tryCatchPattern":"if impeccable init; then :; else echo 'init is an agent-chat verb; use /impeccable init in Claude Code/Cursor/Codex'; fi","preventionTips":["Remember the terminal CLI and agent-chat skill verbs are separate surfaces","Use --help to discover valid terminal commands","Never strip the leading slash from /impeccable init"],"tags":["cli","usage","wrong-context"],"backgroundTag":"command-not-found","analyzedSha":"2bc2879276c1f321a53c4ca99d3371e411329b52","analyzedAt":"2026-09-08T04:51:14.109Z","contentChangedAt":"2026-09-08T04:51:14.109Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}