Developer Documentation

# Install globally
npm install -g @codecontext/cli

# Verify installation
codecontext --version
# Output: codecontext/1.0.0 darwin-arm64 node-v18.17.0

# Initialize in your repo
cd your-project
codecontext init

# This creates:
# - .codecontext/config.yaml (configuration)
# - .codecontext/policies/ (OPA rules)
# - .codecontext/evidence/ (Evidence Packs storage)

# Plan a campaign (dry run)
codecontext campaign plan "Add error handling to all API endpoints" \
  --scope "src/api/**/*.js" \
  --budget-tokens 50000 \
  --budget-dollars 5

# Review the plan
codecontext campaign review

# Apply the changes
codecontext campaign apply --with-tests

# .codecontext/config.yaml
version: 1.0

organization:
  id: "org_abc123"
  name: "Acme Corp"

models:
  primary: "gpt-4-turbo"
  fallback: "claude-3-opus"
  region: "us-east-1"

policies:
  enforce: true
  fail_closed: true
  paths:
    - ".codecontext/policies/*.rego"
    - ".github/policies/*.rego"

budgets:
  default_tokens: 100000
  default_dollars: 10
  max_per_campaign: 500000

evidence:
  retention_days: 90
  sign_with_gpg: true
  include_test_logs: true

curl https://api.codecontext.ai/v1/campaigns \
  -H "Authorization: Bearer cc_live_abc123..." \
  -H "Content-Type: application/json"

codecontext init [options]

Options:
  --org-id <id>        Organization ID
  --model <model>      Default model (gpt-4-turbo, claude-3-opus)
  --region <region>    Processing region (us-east-1, eu-west-1)
  --air-gapped         Enable air-gapped mode (no internet)
  --skip-git-hooks     Don't install git hooks

Examples:
  codecontext init --org-id org_abc123
  codecontext init --model claude-3-opus --region eu-west-1

codecontext campaign <command> [options]

Commands:
  plan <objective>     Create a campaign plan
  review [id]          Review pending campaign
  apply [id]           Apply campaign changes
  rollback <id>        Rollback a campaign
  list                 List all campaigns
  status <id>          Get campaign status

Options (plan):
  --scope <pattern>    File scope (glob pattern)
  --exclude <pattern>  Exclude files
  --budget-tokens <n>  Max tokens to use
  --budget-dollars <n> Max cost in USD
  --model <model>      Override default model
  --policy <file>      Additional policy file

Examples:
  codecontext campaign plan "Add TypeScript types" --scope "src/**/*.js"
  codecontext campaign apply --with-tests --auto-commit
  codecontext campaign rollback campaign_xyz789

curl https://api.codecontext.ai/v1/campaigns \
  -H "Authorization: Bearer cc_live_abc123..." \
  -H "Content-Type: application/json"

# .github/workflows/codecontext.yml
name: CodeContext AI Campaign

on:
  workflow_dispatch:
    inputs:
      objective:
        description: 'Campaign objective'
        required: true
      scope:
        description: 'File scope pattern'
        default: 'src/**/*.ts'

jobs:
  campaign:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup CodeContext
        uses: codecontext/setup-action@v1
        with:
          api-key: ${{ secrets.CODECONTEXT_API_KEY }}
          
      - name: Plan Campaign
        run: |
          codecontext campaign plan \
            "${{ github.event.inputs.objective }}" \
            --scope "${{ github.event.inputs.scope }}" \
            --budget-tokens 100000
            
      - name: Apply Changes
        run: codecontext campaign apply --with-tests
        
      - name: Upload Evidence Pack
        uses: actions/upload-artifact@v3
        with:
          name: evidence-pack
          path: .codecontext/evidence/*.json

# .gitlab-ci.yml
stages:
  - plan
  - apply

variables:
  CODECONTEXT_API_KEY: ${CODECONTEXT_API_KEY}

plan_campaign:
  stage: plan
  script:
    - npm install -g @codecontext/cli
    - codecontext campaign plan "$OBJECTIVE" --scope "$SCOPE"
  artifacts:
    paths:
      - .codecontext/campaigns/

apply_campaign:
  stage: apply
  when: manual
  script:
    - codecontext campaign apply --with-tests
  artifacts:
    paths:
      - .codecontext/evidence/

// Jenkinsfile (Declarative)
pipeline {
  agent any
  environment {
    CODECONTEXT_API_KEY = credentials('cc-api-key')
  }
  stages {
    stage('Plan') {
      steps {
        sh 'npm install -g @codecontext/cli'
        sh 'codecontext campaign plan "Harden K8s manifests" --scope "k8s/**/*.yaml" --budget-tokens 75000'
      }
    }
    stage('Apply') {
      steps {
        input message: 'Apply campaign?', ok: 'Apply'
        sh 'codecontext campaign apply --with-tests'
        archiveArtifacts artifacts: '.codecontext/evidence/*.json', fingerprint: true
      }
    }
  }
}

# azure-pipelines.yml
trigger: none

pool:
  vmImage: ubuntu-latest

steps:
  - checkout: self
  - task: Bash@3
    displayName: Install CLI
    inputs:
      targetType: inline
      script: |
        npm install -g @codecontext/cli
  - task: Bash@3
    displayName: Plan Campaign
    inputs:
      targetType: inline
      script: |
        codecontext campaign plan "Upgrade dependencies + SBOM" --scope "src/**" --budget-tokens 100000
  - task: Bash@3
    displayName: Apply Changes
    inputs:
      targetType: inline
      script: |
        codecontext campaign apply --with-tests