Skip to main content

Common Issues

keypress command not found​

  • Reinstall globally: npm install -g keypress
  • Verify npm global bin path is in your PATH
  • Reopen terminal and run keypress --version

Can't authenticate with Keypress​

  • Run: keypress auth login
  • If state looks broken, force reset auth:
    • keypress auth login --force

Claude mode does not start​

  • Confirm claude is installed and authenticated
  • Retry with keypress --help to ensure CLI dispatch is healthy

Gemini auth or project errors​

  • Reconnect Gemini: keypress connect gemini
  • For Workspace accounts, set project:
    • keypress gemini project set <project-id>

Companion app cannot see my session​

  • Confirm session is running locally
  • Check daemon status: keypress daemon status
  • Restart daemon:
keypress daemon stop
keypress daemon start

Session feels stuck or out of sync​

  • Run: keypress doctor
  • If needed: keypress doctor clean
  • Check latest daemon log path: keypress daemon logs
Screenshot Placeholder
  • What to capture: A troubleshooting decision flow (symptom list to command fixes).
  • Why this screenshot matters: Lets users self-serve quickly without reading every section.
  • Suggested filename: troubleshooting-symptom-to-fix-map.png