OCCode CLI v0.1.0

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

Download & Install

# 1. Download the zip file for your platform from the links below
# 2. Obtain your license key from your opencan.ai dashboard
# 3. Extract the zip file:

# Linux/macOS
unzip occode-linux-x64.zip
sudo mv occode /usr/local/bin/

# Windows - right-click the .zip → Extract All, then add folder to PATH

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

Platform Downloads

Download the zip file for your platform (free account required):

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

# macOS
shasum -a 256 occode-macos-x64.zip
shasum -a 256 occode-macos-arm64.zip

# Linux
sha256sum occode-linux-x64.zip

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 zip file: occode-windows-x64.zip (47 MB)
2. Obtain your license key from your opencan.ai dashboard
3. Verify the checksum (PowerShell): Get-FileHash occode-windows-x64.zip -Algorithm SHA256
   Expected: 7f4840e8355a2ec64adfe0e667f1486acf19c5313fbb49dcc3c750636307b85a
4. Extract the ZIP file to a location (e.g., C:\Program Files\OCCode)
5. Add to PATH:
   • Open System Properties → Advanced → Environment Variables
   • Edit the Path variable for your user
   • Add the folder containing occode.exe
6. Activate your license key:

occode activate --key YOUR-LICENSE-KEY
occode --version
# Should output: OCCode CLI v0.1.0

Quick Install (PowerShell)

# Extract the downloaded zip
Expand-Archive -Path "occode-windows-x64.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, then activate and verify
occode activate --key YOUR-LICENSE-KEY
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 zip file:
   • Intel Mac: occode-macos-x64.zip (51 MB)
   • Apple Silicon: occode-macos-arm64.zip (51 MB)
2. Obtain your license key from your opencan.ai dashboard
3. Verify the checksum:

   shasum -a 256 occode-macos-*.zip

   • Intel: b62c578b38e771961b53b75f3851edb816ce0339155251af7bf9cf0847640c24
   • ARM: 53befd5d8d381e24d1bb85072e6332e565350973595cea4210bb7fd227a0e3b5
4. Extract and install:

# Extract the zip
unzip occode-macos-*.zip

# Move to /usr/local/bin
sudo mv occode /usr/local/bin/occode
sudo chmod +x /usr/local/bin/occode

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

# Verify
occode --version

# 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 zip file: occode-linux-x64.zip (50 MB)
2. Obtain your license key from your opencan.ai dashboard
3. Verify the checksum:

   sha256sum occode-linux-x64.zip

   Expected: fe27a7e04d1d6aa8511de2e23436f6f2891ad01de8d8cffb84cead12f790b965
4. Extract and install:

# Extract the zip
unzip occode-linux-x64.zip

# Install to /usr/local/bin
sudo mv occode /usr/local/bin/occode
sudo chmod +x /usr/local/bin/occode

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

# Verify
occode --version

User-level Installation (No sudo)

# Install to ~/.local/bin
mkdir -p ~/.local/bin
unzip occode-linux-x64.zip -d ~/.local/bin/
chmod +x ~/.local/bin/occode

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

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

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