@contextium/cli 0.7.0 → 0.7.1

package/README.md

@@ -1,227 +1,149 @@
 # Contextium CLI
 
-Command-line interface for Contextium that allows developers to fetch and pipe documentation to external AI tools.
+CLI for managing Contextium workspaces, context libraries, files, workflows, agents, skills, tags, and marketplace installs.
 
-## Installation
+## Install
 
 ```bash
-# Build the CLI
-npm run build
-
-# Link for local development
-npm link
+npm i -g @contextium/cli
 ```
 
-## Setup
-
-### 1. Initialize a Project
+Or run without installing globally:
 
 ```bash
-# Navigate to your project directory
-cd /path/to/your/project
-
-# Initialize Contextium with your workspace and project
-contextium init \
-  --api-key YOUR_API_KEY \
-  --workspace your-workspace-slug \
-  --project your-project-slug \
-  --api-url http://localhost:3001/api/v1
-
-# Or use environment variable for API key
-export CONTEXTIUM_API_KEY=your_api_key
-contextium init --workspace your-workspace-slug --project your-project-slug
+npx @contextium/cli --help
 ```
 
-This creates:
-- `.contextiumrc` - Configuration file
-- `.contextium-cache/` - Local cache directory
-- Updates `.gitignore` to exclude cache directory
-
-### 2. Sync Files
-
-Download all project files to local cache:
+## Quick Start
 
 ```bash
-# Sync all files
-contextium sync
+# 1) Sign in
+contextium login
 
-# Sync specific files
-contextium sync README.md API_GUIDE.md
+# 2) Optional guided setup
+contextium setup
 
-# Sync files with specific tags
-contextium sync --tag foundation-context --tag always-include
+# 3) See your workspaces
+contextium workspaces
 
-# Force re-download all files
-contextium sync --force
+# 4) List context libraries in a workspace
+contextium libraries -w my-workspace
 
-# Dry run to see what would be synced
-contextium sync --dry-run
+# 5) Find and read files
+contextium find auth -w my-workspace
+contextium cat README.md -w my-workspace
 ```
 
-## Usage
+## Command Groups
 
-### Check Status
+### Auth
 
-Check which files are cached and up-to-date:
+- `contextium login`
+- `contextium logout`
+- `contextium whoami`
 
-```bash
-contextium status
-```
+### Setup
 
-Output:
-```
-Project: My Project
-Project ID: abc-123
-Workspace: my-workspace
+- `contextium setup`
+- `contextium init`
+- `contextium setup-claude`
 
-✓ README.md v3 (up to date)
-↓ API_GUIDE.md v2 (v5 available, 3 versions behind)
-? SETUP.md (not cached)
+### Workspace and Libraries
 
-2 file(s) need update - run 'contextium sync'
-1 file(s) not cached - run 'contextium sync'
-```
+- `contextium workspaces`
+- `contextium libraries -w <workspace>`
+- `contextium create-library -w <workspace> -n "Docs"`
+- `contextium update-library <libraryId> -n "New Name"`
 
-### Output File Content
+### Files and Content
 
-Output file content to stdout for piping to AI tools:
+- `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>`
 
-```bash
-# Output all files
-contextium cat --all
-
-# Output specific files
-contextium cat README.md API_GUIDE.md
-
-# Output files with specific tags
-contextium cat --tag always-include
-
-# Include metadata headers
-contextium cat --all --with-meta
+### Search
 
-# Output as JSON
-contextium cat --all --format json
-```
-
-### Pipe to External AI Tools
+- `contextium search "authentication" -w <workspace>`
+- `contextium find "api" -w <workspace>`
 
-The primary use case - pipe documentation to AI tools like Cursor, Claude, or Copilot:
+### Tags
 
-```bash
-# Pipe all documentation to clipboard
-contextium cat --all | pbcopy
+- `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"`
 
-# Pipe to Cursor
-contextium cat --all | cursor --add-context
+### Agents and Skills
 
-# Pipe foundation docs to Claude
-contextium cat --tag foundation-context | claude --context
+- `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"`
 
-# Pipe specific files
-contextium cat README.md API_GUIDE.md | cursor --add-context
-```
+### Workflows
 
-### Search Files
+- `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>`
 
-Search for files in your project:
+### Marketplace
 
-```bash
-# Search by filename or content
-contextium search "authentication"
+- `contextium marketplace list`
+- `contextium marketplace list --type skill --category backend`
+- `contextium marketplace show code-review-assistant`
+- `contextium marketplace install code-review-assistant -w <workspace>`
 
-# Search with tag filter
-contextium search "api" --tag backend
+## Global Flags
 
-# Limit results
-contextium search "guide" --limit 5
-```
+- `-w, --workspace <name|slug|id>`: workspace selector for workspace-scoped commands
+- `-h, --help`: show command help
+- `-V, --version`: show CLI version
 
-## Configuration
-
-The `.contextiumrc` file contains your project configuration:
-
-```json
-{
-  "api_key": "your-api-key",
-  "api_url": "http://localhost:3001/api/v1",
-  "project_id": "project-uuid",
-  "workspace": "workspace-slug",
-  "cache": {
-    "enabled": true,
-    "ttl": 3600,
-    "directory": ".contextium-cache",
-    "max_size_mb": 100
-  },
-  "sync": {
-    "auto": true,
-    "on_command": ["build", "test"],
-    "notify_changes": true,
-    "interval": 300
-  },
-  "files": {
-    "include": [],
-    "exclude": ["DEPRECATED_*.md", "DRAFT_*.md"],
-    "tags": ["foundation-context", "always-include"],
-    "auto_include_tags": true
-  }
-}
-```
+Run `contextium <command> --help` for command-specific flags.
 
-## Workflow Example
+## Typical Workflow
 
 ```bash
-# 1. Initialize in your project
-cd ~/projects/my-app
-contextium init --workspace my-company --project my-app
-
-# 2. Sync all documentation
-contextium sync
-
-# 3. Start coding with AI assistance
-# Pipe all relevant docs to your AI tool
-contextium cat --tag always-include | cursor --add-context
-
-# 4. Update when docs change
-contextium status  # Check for updates
-contextium sync    # Download latest versions
+# 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>
 ```
 
-## Cache Management
-
-The CLI caches files locally for faster access:
-
-- Cache directory: `.contextium-cache/`
-- TTL: 1 hour (configurable)
-- Auto-syncs based on configuration
-- Use `--no-cache` flag to bypass cache
-
 ## Development
 
 ```bash
-# Build
 npm run build
-
-# Watch mode
 npm run dev
-
-# Type check
 npm run type-check
 ```
-
-## Architecture
-
-The CLI is designed to be a lightweight bridge between your Contextium documentation repository and external AI coding tools:
-
-```
-Your Project
-    ↓
-Contextium CLI (fetch docs)
-    ↓
-Local Cache (.contextium-cache/)
-    ↓
-Pipe to AI Tool (Cursor, Claude, Copilot)
-    ↓
-AI-assisted Development
-```
-
-For more information, see the [Platform Specification](../../Resources/CONTEXTHUB_PLATFORM_SPEC.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextium/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Command-line tool for managing Contextium documentation, agents, skills, and workflows — pipe context to AI coding assistants",
   "keywords": [
     "contextium",