CLI Reference
timecampus from @timecampus/cli. A thin shell over @burdenoff/cli-sdk — all command logic lives in shared SDK modules. This package builds the product CLIContext, mounts the TimeCampus surface, and wires the Commander program.
Install
npm install -g @timecampus/cli
# or
bun add -g @timecampus/cli
Authentication
timecampus auth login
OAuth2 device-code flow. See Authentication for full detail.
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 |
timecampus | TimeCampus domain — projects, tasks, time-entries, meetings, expenses, pomodoro, resource-plans, approvals, 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 timecampus <command> --help for subcommand details.
Common examples
# Auth
timecampus auth login
timecampus auth status
timecampus auth token --workspace
# Workspace
timecampus workspace list
timecampus workspace set <id>
# TimeCampus domain
timecampus timecampus projects list
timecampus timecampus time-entries running
timecampus timecampus tasks list --project-id <pid>
# Tags & RBAC
timecampus tags create --key bug --label Bug
timecampus rbac check <user> read project
# Billing & devportal
timecampus billing subscriptions list
timecampus devportal apps list --status PUBLISHED
Output formats
All list/get commands support --format (-f): json, table, yaml.
timecampus timecampus projects list --format json
Environment selection
The CLI defaults to production. Override via BURDENOFF_ENV:
BURDENOFF_ENV=local timecampus auth login
BURDENOFF_ENV=alpha timecampus workspace list
Direct endpoint overrides (highest priority):
TIMECAMPUS_WORKSPACE_ENDPOINT=https://custom.example.com/graphql timecampus auth status
TIMECAMPUS_GLOBAL_ENDPOINT=https://custom.example.com/global/graphql timecampus workspace list
Configuration
CLI settings are stored in ~/.config/timecampus-cli/.
Default endpoints (production):
- Workspace gateway:
https://graphqlworkspaces.burdenoff.com/workspaces/graphql - Global gateway:
https://graphql.burdenoff.com/global/graphql
Development
git clone https://github.com/Algoshred/timecampus-cli.git
cd timecampus-cli
bun install
bun run dev # Run CLI in dev mode (tsx)
bun run build # Compile TypeScript
bun run sanity # All checks (format + lint + type-check + build)
Source
Published as @timecampus/cli on npm; source at github.com/algoshred/timecampus-cli.