ContxOS CLI

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

Installation

``bash


Install globally

npm install -g @contxos/cli

Or use with npx

npx @contxos/cli
`

Authentication

ContxOS CLI supports two authentication methods:

$3

`bash


Browser-based OAuth flow (opens browser automatically)

contxos login

Manual 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 logout

Check authentication status

contxos status

Show 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 5

JSON 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 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

$3

`bash


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
`

$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/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