ContxOS CLI

Professional command-line interface for ContxOS - an intent-based AI system management platform.

Installation

# Install globally
npm install -g @contxos/cli

# Or use with npx
npx @contxos/cli

Authentication

ContxOS CLI supports two authentication methods:

OAuth (Recommended)

# Browser-based OAuth flow (opens browser automatically)
contxos login

# Manual OAuth flow (for SSH/remote sessions)
contxos login --manual

Direct Token

# Login with an API token
contxos login YOUR_TOKEN_HERE

Commands

Authentication

# Login (OAuth or token)
contxos login [token]

# Logout
contxos logout

# Check authentication status
contxos status

# Show current user and project
contxos whoami

Intent Execution

# Execute an intent
contxos execute <intent> <confidence> <prompt>
contxos exec test 0.8 "run the tests"

# With JSON output
contxos execute test 0.8 "validate the system" --json

Search & Query

# Search thoughts
contxos search "oauth implementation"
contxos search "test results" --limit 5

# JSON output
contxos search "api" --json

Create Thoughts

# Create a new thought
contxos think "Important insight about the system" insight
contxos think "Decision to use TypeScript" decision

System Information

# List available intents
contxos intents

# List branches
contxos branches
contxos branches test  # Filter by intent

# JSON output
contxos intents --json

Options

Most commands support these global options:

• --json, -j - Output in JSON format
• --help, -h - Show help for a command

Examples

Complete Workflow

# 1. Install the CLI
npm install -g @contxos/cli

# 2. Authenticate
contxos login

# 3. Check your identity
contxos whoami

# 4. Execute an intent
contxos exec test 0.8 "test the authentication system"

# 5. Search for results
contxos search "test results" --limit 5

# 6. Create a thought about your findings
contxos think "OAuth implementation working correctly" result

SSH/Remote Session

# Use manual OAuth flow when browser isn't available
contxos login --manual
# Visit the URL shown, copy the code, paste it back

# Or use direct token authentication
contxos login dee31c39-db71-4835-a411-16aac5e07bc2

Configuration

The CLI stores configuration in:

• macOS: ~/Library/Preferences/contxos-cli/
• Linux: ~/.config/contxos-cli/
• Windows: %APPDATA%/contxos-cli/

Development

# Clone the repository
git clone https://github.com/ramonglez15/contxOS.git
cd contxOS/cli

# Install dependencies
npm install

# Build the CLI
npm run build

# Link for local testing
npm link

# Now you can use 'contxos' command globally
contxos --version

License

MIT