FAQ

Home > FAQs > Install

How do I install OpenCues?

Three steps: install the CLI, add a model key, install into your host. macOS and Linux natively; Windows inside WSL2.

The steps

npm install -g opencues gets the CLI. Add a key (Cerebras recommended: opencues set-key cerebras <key>, or export CEREBRAS_API_KEY). Then per host: opencues install claude-code, opencues install opencode, opencues install gemini-cli, opencues install shell, or the Chrome extension. Native hosts get a dedicated patched copy, so your regular installs are untouched; launch with opencues run <host>.

First run

The installer seeds ~/.cues/ with the shipped defaults: tip packs, the spelling cue, and system blanks like volume and weather. Type 4 + 4 = _ in a supported host to confirm it's alive, and opencues doctor diagnoses anything that isn't.

Related: Claude Code guide · Uninstalling · Troubleshooting · Best practices · System requirements · GitHub repo