OCCode CLI v0.1.0

AI-powered coding assistant for the terminal with multi-provider support

📦 Download & Install

# After downloading the archive for your platform:
# Linux/macOS
tar xzf occode-0.1.0-linux-x64.tar.gz
sudo mv occode /usr/local/bin/

# Windows - extract the .zip, then add to PATH

# Activate with your license key
occode activate --key YOUR-LICENSE-KEY

💾 Platform Downloads

Download the archive for your platform (account login required):

# Windows (PowerShell)
Get-FileHash occode-0.1.0-windows-x64.zip -Algorithm SHA256

# macOS/Linux
shasum -a 256 occode-0.1.0-macos-x64.tar.gz
sha256sum occode-0.1.0-linux-x64.tar.gz

🪟 Windows Installation

Requirements

• Windows 10 version 1809 or later (64-bit)
• 2 GB RAM minimum
• 50 MB free disk space

Installation Steps

1. Download the Windows package: occode-0.1.0-windows-x64.zip
2. Extract the ZIP file to a location (e.g., C:\Program Files\OCCode)
3. Add to PATH:
   • Open System Properties → Advanced → Environment Variables
   • Edit the Path variable for your user
   • Add the folder containing occode.exe
4. Verify installation:

occode --version
# Should output: OCCode CLI v0.1.0

Quick Install (PowerShell)

# Download and extract
Invoke-WebRequest -Uri "https://www.opencan.ai/downloads/occode-cli/0.1.0/occode-0.1.0-windows-x64.zip" -OutFile "occode.zip"
Expand-Archive -Path "occode.zip" -DestinationPath "$env:LOCALAPPDATA\OCCode"

# Add to PATH (user-level)
$path = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$path;$env:LOCALAPPDATA\OCCode", "User")

# Restart terminal and verify
occode --version

🍎 macOS Installation

Requirements

• macOS 10.15 (Catalina) or later
• Intel or Apple Silicon (M1/M2/M3) processor
• 2 GB RAM minimum
• 50 MB free disk space

Installation Steps

1. Download the appropriate package:
   • Intel Mac: occode-0.1.0-macos-x64.tar.gz
   • Apple Silicon: occode-0.1.0-macos-arm64.tar.gz
2. Extract and install:

# Extract
tar -xzf occode-0.1.0-macos-*.tar.gz

# Move to /usr/local/bin
sudo mv occode-0.1.0-macos-* /usr/local/bin/occode
sudo chmod +x /usr/local/bin/occode

# Verify
occode --version

Quick Install (One-liner)

# Intel Mac
curl -L https://www.opencan.ai/downloads/occode-cli/0.1.0/occode-0.1.0-macos-x64.tar.gz | tar xz && sudo mv occode-* /usr/local/bin/occode && sudo chmod +x /usr/local/bin/occode

# Apple Silicon (M1/M2/M3)
curl -L https://www.opencan.ai/downloads/occode-cli/0.1.0/occode-0.1.0-macos-arm64.tar.gz | tar xz && sudo mv occode-* /usr/local/bin/occode && sudo chmod +x /usr/local/bin/occode

# Remove quarantine attribute
xattr -d com.apple.quarantine /usr/local/bin/occode

# Or allow in System Preferences → Security & Privacy

🐧 Linux Installation

Requirements

• 64-bit x86_64 processor
• GLIBC 2.28 or later
• 2 GB RAM minimum
• 50 MB free disk space

Installation Steps

1. Download the Linux package: occode-0.1.0-linux-x64.tar.gz
2. Extract and install:

# Extract
tar -xzf occode-0.1.0-linux-x64.tar.gz

# Install to /usr/local/bin
sudo mv occode-0.1.0-linux-x64 /usr/local/bin/occode
sudo chmod +x /usr/local/bin/occode

# Verify
occode --version

Quick Install (One-liner)

curl -L https://www.opencan.ai/downloads/occode-cli/0.1.0/occode-0.1.0-linux-x64.tar.gz | tar xz && sudo mv occode-* /usr/local/bin/occode && sudo chmod +x /usr/local/bin/occode

User-level Installation (No sudo)

# Install to ~/.local/bin
mkdir -p ~/.local/bin
tar -xzf occode-0.1.0-linux-x64.tar.gz -C ~/.local/bin/
chmod +x ~/.local/bin/occode-*

# Add to PATH if not already
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

⚙️ Configuration

First-Time Setup

After installation, configure OCCode with your AI provider:

# Interactive configuration wizard
occode config

# Or set provider and API key directly
occode config --set provider=anthropic
occode config --set-key --provider anthropic

Supported AI Providers

Configuration File

Settings are stored in ~/.occode/config.json:

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 4096,
  "temperature": 0.7,
  "autoApprove": false
}

View All Providers

occode config --list-providers

🚀 Usage & Examples

Interactive Chat Mode

# Start interactive session
occode

# Or explicitly
occode chat

# Resume previous session
occode --session last

Run Single Tasks

# Execute a task
occode run "Add unit tests for UserService"

# Autonomous mode (no approvals)
occode run "Fix all TypeScript errors" --yes

# With specific files in context
occode run "Refactor this component" -c src/App.tsx

# Dry run (preview without executing)
occode run "Update dependencies" --dry-run

Code Operations

# Explain code
occode explain src/auth.ts

# Review code for issues
occode review --security src/

# Generate documentation
occode generate readme

# Search codebase semantically
occode search "authentication logic"

Git Integration

# AI-generated commit message
occode commit

# Auto-stage and commit
occode commit -a

# Commit and push
occode commit -ap

Watch Mode

# Watch for changes and run tasks
occode watch -t "Run tests on changed files"

# Watch specific pattern
occode watch -p "src/**/*.ts" -t "Type check"

✨ Key Features

Interactive Commands

Available slash commands in chat mode:

🔧 Troubleshooting

Command Not Found

Issue: occode: command not found

Solution:

• Ensure OCCode is in your PATH
• Restart your terminal after installation
• Verify install: run occode --version
• Check the binary is in /usr/local/bin or another PATH directory

API Key Not Found

Issue: Error about missing API key

Solution:

# Set API key securely
occode config --set-key --provider anthropic

# Or via environment variable
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

Permission Denied (Linux/macOS)

Issue: Permission denied when running occode

Solution:

chmod +x /usr/local/bin/occode

Model Not Available

Issue: Error about model not being available

Solution:

# List available models for your provider
occode config --list

# Set a valid model
occode config --set model=claude-sonnet-4-20250514

Connection Timeout

Issue: Requests timeout

Solution:

• Check your internet connection
• Verify API key is valid and has credits
• Increase timeout: occode run "task" --timeout 600
• Check provider status page

Uninstall OCCode

# Remove the binary
sudo rm /usr/local/bin/occode        # macOS/Linux
del %LOCALAPPDATA%\OCCode\occode.exe # Windows

# Remove config (optional)
rm -rf ~/.occode

Get Help

# View all commands
occode --help

# View help for specific command
occode run --help
occode config --help

# Check version
occode --version

Quick Reference