Devin CLI (Unofficial) — The Professional Terminal Interface for Devin AI

The first unofficial CLI for the world's first AI Software Engineer. Supports both the modern v3 API and the legacy v1 API with full multi-profile management.

Devin CLI is designed for high-velocity engineering teams. It strips away the friction of the web UI, allowing you to orchestrate autonomous agents, manage complex contexts, and automate multi-step development workflows through a robust, terminal-first interface.

⚡ Quick Start

1. Installation

Recommended: Via Homebrew (macOS)

brew tap revanthpobala/tap
brew install devin-cli

Via pipx (Isolated environment)

pipx install devin-cli

Via pip

pip install devin-cli

2. Configuration

# Interactive setup:
devin configure
# Paste your API token (apk_... or cog_...) from https://preview.devin.ai/settings
# Select API version: v3 (default) or v1 (legacy)

# Or non-interactive / CI setup:
devin configure --token "$DEVIN_API_TOKEN" --org "$DEVIN_ORG_ID" --yes

3. Your First Session

devin create-session "Identify and fix the race condition in our Redis cache layer"
devin watch

Authentication & Usage

AI Agent Integration (JSON Output)

For external automation and AI agent architectures relying on the CLI, devin-cli supports a global --json flag. This will suppress all visual output/terminal colors and instead uniformly return raw JSON objects for stdout and API errors, making the CLI completely deterministic to parse.

devin --json sessions create "My prompt"
# { "session_id": "...", "status": "running" }

Multi-Profile Support

devin configure --profile personal
devin configure --profile service
devin --profile service sessions list
devin --profile personal sessions create "Fix the failing tests"

Profiles are stored in ~/.config/devin/config.json — fully isolated including session caches and active session IDs.

Automation & CI / CD

devin-cli is fully optimized for headless CI/CD runners (GitHub Actions, GitLab CI, Jenkins) and containerized workflows.

Precedence Resolution

Credentials and configuration resolve in a strict, predictable order:

1. Global CLI Flags (--token, --org, --base-url, --api-version)
2. Environment Variables (DEVIN_API_TOKEN, DEVIN_ORG_ID, DEVIN_BASE_URL, DEVIN_API_VERSION)
3. Config File (DEVIN_CONFIG_FILE or ~/.config/devin/config.json)
4. Built-in Defaults (base_url: https://api.devin.ai/v3, api_version: v3)

Ephemeral Runs (Zero Disk Writes)

In CI pipelines, you do not need to create or write configuration files. Pass credentials via environment variables or root CLI flags:

# Option A: Environment variables
export DEVIN_API_TOKEN="cog_..."
export DEVIN_ORG_ID="org-..."
devin repos list --json

# Option B: Global CLI flags on-the-fly
devin --token "$DEVIN_API_TOKEN" --org "$DEVIN_ORG_ID" repos status my-org/my-repo --json

Non-Interactive Configuration

If your pipeline writes a config file, use --yes (or run in non-TTY environments) to disable interactive prompts:

devin configure \
  --token "$DEVIN_API_TOKEN" \
  --org "$DEVIN_ORG_ID" \
  --base-url https://api.devin.ai/v3 \
  --api-version v3 \
  --yes

Custom Config File Path

Override the default ~/.config/devin/config.json location:

# Via flag
devin --config-file /tmp/devin-ci.json repos list

# Via environment variable
export DEVIN_CONFIG_FILE=/tmp/devin-ci.json

🤖 All Commands

Flat Commands (0.1.x style — quick access)

Sessions (devin sessions <cmd>)

Note for Service Tokens (cog_): When retrieving a specific session via devin sessions get <id>, the CLI automatically falls back to filtering the org-wide sessions list via a ?session_ids=[<id>] query parameter to gracefully bypass the 403 Forbidden error natively returned by the direct API endpoint for service accounts.

sessions create / create-session — Full Flag Reference

Full Batch Automation Example

# No browser interaction required
devin sessions create \
  --devin-mode fast \
  --advanced-mode batch \
  --playbook-id <orchestrator-id> \
  --child-playbook-id <worker-id> \
  --bypass-approval \
  "Process each file in the attached CSV"

PR Reviews (devin pr-reviews <cmd>)

Organization Session Tags (devin tags <cmd>)

Snapshot Blueprints (devin blueprints <cmd>)

Knowledge (devin knowledge <cmd>)

Playbooks (devin playbooks <cmd>)

Secrets (devin secrets <cmd>)

Schedules (devin schedules <cmd>)

Repositories (devin repos <cmd>)

Attachments (devin attachments <cmd>)

Enterprise Management (devin enterprise <cmd>)

Chain (devin chain)

Orchestrate a sequential pipeline of playbooks:

# Inline
devin chain "Refactor utils.py" --playbooks "lint_check,unit_tests"

# YAML workflow file
devin chain --file workflow.yml

🛡 Session Deduplication

The CLI caches a SHA-256 hash of your last 50 prompts per profile. Duplicate prompts are caught before wasting ACUs:

Duplicate Detected: You recently created a session with this exact prompt.
Existing Session ID: abc123...
Are you sure you want to create a duplicate session? [y/N]

Use --force to bypass.

📟 CI/CD Integration

env:
  DEVIN_API_TOKEN: ${{ secrets.DEVIN_API_TOKEN }}
  DEVIN_ORG_ID: ${{ secrets.DEVIN_ORG_ID }}
run: |
  devin create-session "Review PR #${{ github.event.pull_request.number }}" --wait

Environment variables:

🕹 v1 / v3 Profile Compatibility

v3-only flags are accepted but ignored on v1 profiles — the CLI prints a clear warning listing exactly which flags were dropped.

⚙️ Engineering Specs

• Architecture: Full v3 API support (v3beta1 + enterprise) + v1 legacy proxy
• Config: ~/.config/devin/config.json
• Platform: Linux, macOS, WSL2
• Python: 3.9+

🧪 Developer Hub

pip install -e ".[dev]"
PYTHONPATH=src python3 -m pytest

📄 License

MIT. Devin CLI is an unofficial community project and is not affiliated with Cognition AI.