CLI Reference
kadaikodi from @kadaikodi/cli. A thin shell over @burdenoff/cli-sdk that mounts the Kadaikodi product context and shared platform modules.
Install
npm install -g @kadaikodi/cli
# or
bun add -g @kadaikodi/cli
Authentication
kadaikodi auth login # OAuth2 device-code flow
kadaikodi auth status # Check current auth state
kadaikodi auth token # Print platform access token
kadaikodi auth token --workspace # Print workspace token
kadaikodi auth refresh # Force token refresh
kadaikodi auth logout # Clear stored tokens
kadaikodi workspace list # List available workspaces
kadaikodi workspace current # Show current workspace
kadaikodi workspace set <id> # Switch workspace (re-issues token)
Token storage: ~/.config/kadaikodi-cli/auth.json (mode 0600).
Top-level command groups
| Group | What |
|---|---|
auth | Authentication (login, logout, status, token, refresh) |
workspace | Workspace context (list, current, set) |
organizations | Organization management |
tours | Product tours |
rbac | Role-based access control |
kadaikodi | Kadaikodi marketplace (providers, workers, tasks, offerings, orders, reviews, investments, analytics) |
sandbox | Sandbox script execution |
tags | Tags |
files | Files |
groups | Groups |
conversations | Conversations |
security | Security |
integrations | Integrations |
channels | Channels |
scheduler | Scheduler |
export | Data export |
notifications | Notifications |
support | Support |
products | Products / feature flags |
billing | Billing |
store | Store |
devportal | Developer portal |
health | Health checks |
Run kadaikodi <command> --help for subcommand details.
Common examples
kadaikodi auth login
kadaikodi workspace set <id>
kadaikodi kadaikodi offerings list
kadaikodi kadaikodi providers list
kadaikodi tags create --key bug --label Bug
kadaikodi rbac check <user> read project
kadaikodi billing subscriptions list
kadaikodi devportal apps list --status PUBLISHED
Output formats
All list/get commands support --format (-f): json, table, yaml.
Environment selection
The CLI defaults to production endpoints:
- Workspace gateway:
https://graphqlworkspaces.burdenoff.com/workspaces/graphql - Global gateway:
https://graphql.burdenoff.com/global/graphql
Override per-config or via env vars: KADAIKODI_WORKSPACE_ENDPOINT, KADAIKODI_GLOBAL_ENDPOINT, KADAIKODI_OIDC_ISSUER.
Alternatively, use BURDENOFF_ENV=local|alpha|prod. See Environment Selection.
Development
git clone https://github.com/algoshred/kadaikodi-cli.git
cd kadaikodi-cli
bun install
bun run dev # Run CLI in dev mode (tsx)
bun run dev -- --help # Dev mode with args
bun run build # Compile TypeScript
bun run type-check # Type checking
bun run lint # ESLint
bun run format # Prettier
bun run sanity # All checks (format + lint + type-check + build)
bun run start # Run compiled CLI
Repository: github.com/algoshred/kadaikodi-cli