ContxOS CLI - Intent-based AI system management
npm install @contxos/cliProfessional command-line interface for ContxOS - an intent-based AI system management platform.
``bashInstall globally
npm install -g @contxos/cli
Authentication
ContxOS CLI supports two authentication methods:
$3
`bash
Browser-based OAuth flow (opens browser automatically)
contxos loginManual OAuth flow (for SSH/remote sessions)
contxos login --manual
`$3
`bash
Login with an API token
contxos login YOUR_TOKEN_HERE
`Commands
$3
`bash
Login (OAuth or token)
contxos login [token]Logout
contxos logoutCheck authentication status
contxos statusShow current user and project
contxos whoami
`$3
`bash
Execute an intent
contxos execute
contxos exec test 0.8 "run the tests"With JSON output
contxos execute test 0.8 "validate the system" --json
`$3
`bash
Search thoughts
contxos search "oauth implementation"
contxos search "test results" --limit 5JSON output
contxos search "api" --json
`$3
`bash
Create a new thought
contxos think "Important insight about the system" insight
contxos think "Decision to use TypeScript" decision
`$3
`bash
List available intents
contxos intentsList branches
contxos branches
contxos branches test # Filter by intentJSON output
contxos intents --json
`Options
Most commands support these global options:
-
--json, -j - Output in JSON format
- --help, -h - Show help for a commandExamples
$3
`bash
1. Install the CLI
npm install -g @contxos/cli2. Authenticate
contxos login3. Check your identity
contxos whoami4. Execute an intent
contxos exec test 0.8 "test the authentication system"5. Search for results
contxos search "test results" --limit 56. Create a thought about your findings
contxos think "OAuth implementation working correctly" result
`$3
`bash
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
`bash
Clone the repository
git clone https://github.com/ramonglez15/contxOS.git
cd contxOS/cliInstall dependencies
npm installBuild the CLI
npm run buildLink for local testing
npm linkNow you can use 'contxos' command globally
contxos --version
``MIT