Skip to content
codika-os

Installation

Prerequisites

Section titled “Prerequisites”
  • Node.js 20+ — node --version
  • A @codika.io email. Non-Codika emails are rejected at /api/auth/cli/* with 403.

Install

Section titled “Install”
Terminal window
npm install -g codika-os
codika-os --version

If npm install -g is blocked by EACCES, set up a user-prefix Node via volta or nvm and retry. npx codika-os … works as a fallback for one-offs but doesn’t wire cleanly into the SessionStart hook trigger, so global install is preferred.

Verify

Section titled “Verify”
Terminal window
codika-os --help

You should see the command list (install, sync, status, whoami, verify, use, logout, config …, auth …).

Next

Section titled “Next”
  • Auth — sign up or log in via OTP.
  • After auth, codika-os install registers the Claude Code hooks. See commands.

If you’d rather not run these manually, the /codika-os:setup-codika-os plugin skill does install + auth + codika-os install in one step. See the quickstart.