Release v1.6.0 · BourbonDog/amicus

What's Changed

Per-subcommand help: amicus <command> --help now prints only that command's options instead of the full global usage, making it easier to find specific command documentation.
Zero-credit OpenRouter key warning: Setup now performs a non-blocking API check and warns when an OpenRouter key is free-tier or has no remaining credit, catching the issue upfront instead of failing at runtime with a 402 error.
Engine recovery guidance in amicus doctor: The opencode-engine check now explains the transient install-rollback failure mode and provides copy-paste recovery steps for users hitting that edge case.
Postinstall Electron verification: When the optional Electron download or extraction fails (including antivirus quarantines), the install now prints a clear non-fatal notice that headless and council runs still work, preventing silent failures.
CI tarball guard: A new check:tarball CI step asserts every lifecycle-referenced script actually ships in the published package, preventing future packaging changes from silently dropping required install scripts.
README "Requirements & Dependencies" section: Consolidated documentation covering Node, git, OpenRouter credits, API-key environment variables, the optional Electron GUI, the bundled opencode engine, and OS support.

Council and headless runs now correctly report failures: Runs where every model call failed (e.g., an OpenRouter 402 error) were being finalized as complete with a 0-byte summary, hiding the error. Non-2xx/402 responses are now detected at the OpenCode client boundary, and failed runs can never default to complete.
amicus_status elapsed time accuracy: The elapsed duration is now bounded by the run's actual completed/aborted/crashed timestamp instead of wall-clock time since start, so finished runs report their real duration.
amicus_setup (MCP) Electron detection: The command no longer claims an Electron window appeared when Electron is unavailable. It now pre-flights and returns an honest error directing you to the headless terminal wizard.
Clearer session-not-found errors: Error messages now name the resolved project so you know which path to pass to the project parameter.
Non-fatal postinstall failures: Skill-copy or MCP-registration failures during postinstall no longer exit non-zero and roll back the entire global install. They now warn and continue, making the install more resilient.
Windows github: install parity: Removed the consumer-facing prepare lifecycle hook that triggered npm's nested clone-prepare-install-cache path on Windows. The github: install now runs identically to the registry install (git hooks are still configured for contributors via postinstall).

Full Changelog: v1.5.1...v1.6.0