@contextium/cli

Contextium CLI

CLI for managing Contextium workspaces, context libraries, files, workflows, agents, skills, tags, and marketplace installs.

Install

npm i -g @contextium/cli

Or run without installing globally:

npx @contextium/cli --help

Quick Start

# 1) Sign in
contextium login

# 2) Optional guided setup
contextium setup

# 3) See your workspaces
contextium workspaces

# 4) List context libraries in a workspace
contextium libraries -w my-workspace

# 5) Find and read files
contextium find auth -w my-workspace
contextium cat README.md -w my-workspace

Command Groups

Auth

• contextium login
• contextium logout
• contextium whoami

Setup

• contextium setup
• contextium init
• contextium setup-claude

Workspace and Libraries

• contextium workspaces
• contextium libraries -w <workspace>
• contextium create-library -w <workspace> -n "Docs"
• contextium update-library <libraryId> -n "New Name"

Files and Content

• contextium files <library> -w <workspace>
• contextium new <library> -t "Guide" -p guide.md -w <workspace>
• contextium edit <fileId> -c "Updated content" -m "Update summary"
• contextium delete <fileId> --confirm
• contextium versions <fileId>
• contextium structure <library> -w <workspace>
• contextium cat --all -w <workspace>
• contextium sync -w <workspace>
• contextium status -w <workspace>

Search

• contextium search "authentication" -w <workspace>
• contextium find "api" -w <workspace>

Tags

• contextium tags types -w <workspace>
• contextium tags create-type -w <workspace> -n "Topic"
• contextium tags list -w <workspace>
• contextium tags create -w <workspace> --type <typeId> --value authentication
• contextium tags apply -w <workspace> --tag topic:authentication --file <fileId>
• contextium tags apply-bulk -w <workspace> --tag <tagId> --files <file1,file2>
• contextium tags remove -w <workspace> --tag <tagId> --file <fileId>
• contextium tags search -w <workspace> --tags topic:authentication
• contextium tags file-tags -w <workspace> --file <fileId>
• contextium tags update -w <workspace> --tag <tagId> --value auth
• contextium tags type-get -w <workspace> --type <typeId>
• contextium tags type-update -w <workspace> --type <typeId> --name "Topic"

Agents and Skills

• contextium agents list -w <workspace>
• contextium agents create -w <workspace> -n "Code Reviewer"
• contextium agents add-skill -w <workspace> --agent <agentId> --skill <skillId>
• contextium agents remove-skill -w <workspace> --agent <agentId> --skill <skillId>
• contextium agents update -w <workspace> --agent <agentId> --name "Reviewer"
• contextium skills list -w <workspace>
• contextium skills create -w <workspace> -n "API Patterns"

Workflows

• contextium workflows list -w <workspace>
• contextium workflows create -w <workspace> -n "Backend Task"
• contextium workflows update -w <workspace> --id <workflowId> --name "Backend Delivery"
• contextium workflow "Backend Task" -w <workspace>

Marketplace

• contextium marketplace list
• contextium marketplace list --type skill --category backend
• contextium marketplace show code-review-assistant
• contextium marketplace install code-review-assistant -w <workspace>

Global Flags

• -w, --workspace <name|slug|id>: workspace selector for workspace-scoped commands
• -h, --help: show command help
• -V, --version: show CLI version

Run contextium <command> --help for command-specific flags.

Typical Workflow

# Authenticate and inspect available resources
contextium login
contextium workspaces
contextium libraries -w my-workspace

# Pull context into your AI workflow
contextium cat --all -w my-workspace | pbcopy

# Create and evolve content
contextium new my-library -t "Runbook" -p runbook.md -w my-workspace
contextium edit <fileId> -c "Updated runbook content" -m "refresh steps"

# Organize with tags
contextium tags create-type -w my-workspace -n "Topic"
contextium tags create -w my-workspace --type <typeId> --value reliability
contextium tags apply -w my-workspace --tag topic:reliability --file <fileId>

Development

npm run build
npm run dev
npm run type-check