codika-os

CLI for codika-os — auth, profiles, and service operations from the terminal.

Scaffolded from codika-cli-template. See CLAUDE.md for the instantiation guide and conventions.

Install

npm install -g codika-os

Or run without installing:

npx codika-os --help

Quick start

New user (OTP signup)

codika-os auth signup-request --email [email protected]
# check your inbox for a 6-digit code
codika-os auth signup-complete --email [email protected] --code 123456
codika-os whoami

Existing user (OTP login)

codika-os auth login-request --email [email protected]
codika-os auth login-complete --email [email protected] --code 123456

Already have an API key from the dashboard

codika-os login                    # interactive, masked input
# or:
codika-os login --api-key <key>

Commands

| Command | What it does | |---|---| | codika-os auth signup-request --email <email> | Email a signup OTP to a new user | | codika-os auth signup-complete --email <email> --code <code> | Verify OTP, create org+user+key | | codika-os auth login-request --email <email> | Email a login OTP to an existing user | | codika-os auth login-complete --email <email> --code <code> | Verify OTP, mint a fresh key | | codika-os login | Paste an existing API key (alias of config set) | | codika-os logout [name] | Remove a profile (default: active) | | codika-os whoami | Show the current identity (calls /verifyApiKey) | | codika-os verify | Validate the active API key against the backend | | codika-os use [name] | Switch active profile or list profiles | | codika-os config show | Display all profiles | | codika-os config clear [--profile <name>] | Wipe config or one profile | | codika-os completion bash\|zsh\|fish | Generate a shell completion script | | codika-os completion --install | Auto-detect shell and install completion | | codika-os hello --message "hi" | EXAMPLE authenticated call — delete in your fork |

All commands accept --json for stable machine-readable output:

{ "success": true, "data": { ... } }
{ "success": false, "status": 401, "error": { "code": "unauthenticated", "message": "..." } }

Configuration

Profiles live at ~/.config/codika-os/config.json (mode 0600). Set XDG_CONFIG_HOME to override the base.

Resolution chains

| Value | Order | |---|---| | API key | --api-key flag → CODIKA_OS_API_KEY env → active profile → error | | Base URL | --api-url flag → CODIKA_OS_API_BASE_URL env → profile baseUrl → production | | Profile | --profile <name> flag → active profile |

Per-profile base URL

codika-os login --base-url http://localhost:5001/<project>/europe-west1 --name local
codika-os use local

Development

npm install
npm run build
npm test

npm link            # `codika-os` now on your PATH
codika-os --help

Target a non-production backend:

CODIKA_OS_API_BASE_URL=http://localhost:5001/<project>/europe-west1 codika-os whoami

Publishing

The v*.*.* tag triggers npm publish via GitHub Actions. See CLAUDE.md → "Publishing to npm".

npm version patch
git push --follow-tags

License

MIT