Cortex OS CLI

Command-line interface for Cortex OS - Lock decisions. Learn faster.

Installation

npm install -g @cortexos/cli

Quick Start

1. Login

Get your API key from Cortex OS Settings and authenticate:

cortex login --api-key YOUR_API_KEY

Or set it as an environment variable:

export CORTEX_API_KEY=your_api_key_here
cortex login

2. Create a Bet

Lock a decision before you act:

cortex bet "Hire Sarah as lead designer"

With more details:

cortex bet "Hire Sarah as lead designer" \
  --reasoning "Portfolio shows strong UX thinking" \
  --success "Ships redesign in 3 months" \
  --review-date 2026-04-15

3. List Your Bets

cortex list

Show more:

cortex list --limit 20

4. Check Today's Reviews

cortex today

Commands

cortex login

Authenticate with Cortex OS.

Options:

• -k, --api-key <key> - Your API key from settings

Example:

cortex login --api-key cortex_abc123...

cortex logout

Remove stored credentials.

cortex logout

cortex bet <choice>

Create a new solo bet.

Arguments:

• <choice> - The decision you're making

Options:

• -r, --reasoning <text> - Why you're making this choice
• -s, --success <signal> - How you'll know it worked
• -d, --review-date <date> - When to review (YYYY-MM-DD)

Example:

cortex bet "Switch to TypeScript" \
  --reasoning "Better type safety and IDE support" \
  --success "Zero runtime type errors in production" \
  --review-date 2026-06-01

cortex list

List your recent bets.

Options:

• -l, --limit <number> - Number of bets to show (default: 10)

Example:

cortex list --limit 5

cortex today

Show decisions due for review today.

cortex today

cortex status

Show current authentication status.

cortex status

Configuration

The CLI stores configuration in ~/.cortexos/config.json:

{
  "apiKey": "cortex_...",
  "workspace": "Your Workspace"
}

Environment Variables

• CORTEX_API_KEY - Your API key (alternative to --api-key flag)
• CORTEX_API_URL - API base URL (default: https://cortexos.com)

Use Cases

Daily Review Workflow

# Morning: Check what needs review
cortex today

# Throughout the day: Lock decisions
cortex bet "Approve design mockups for v2"
cortex bet "Merge PR #234"

# Evening: Review your bets
cortex list

Quick Decision Logging

# Lock a decision with context
cortex bet "Use PostgreSQL for analytics" \
  --reasoning "Better JSON support than MySQL" \
  --success "Query performance under 100ms"

Integration with Scripts

#!/bin/bash
# Lock deployment decisions
cortex bet "Deploy v2.1.0 to production" \
  --reasoning "All tests passing, QA approved" \
  --review-date $(date -d "+7 days" +%Y-%m-%d)

Support

• Documentation: https://cortexos.com/docs
• Issues: https://github.com/cortexos/cortexos-cli/issues
• Email: [email protected]

License

MIT © Cortex OS