Getting Started

Set up the Cdoing Agent development environment and start coding in minutes.

Prerequisites

Node.js ≥ 18.0.0
Yarn (workspace-based monorepo)
Git for version control
An API key from at least one LLM provider (Anthropic, OpenAI, Google, or a local Ollama instance)

Installation

Clone the repository

git clone https://github.com/your-org/cdoing-agent.git
cd cdoing-agent

Install dependencies

yarn install

Build all packages

yarn build

This runs Turbo to build packages in dependency order: core → ai → cli / vscode-extension.

Configure your API key

yarn start

On first run, the CLI setup wizard will ask you to select a provider and enter your API key. Configuration is saved to ~/.cdoing/config.json.

Configuration

The main configuration file lives at ~/.cdoing/config.json:

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-6",
  "apiKeys": {
    "anthropic": "sk-ant-...",
    "openai": "sk-...",
    "google": "AIza..."
  },
  "mode": "default",
  "indexer": {
    "autoIndex": true,
    "embeddingProvider": "openai",
    "embeddingModel": "text-embedding-3-small"
  }
}

Configuration Options

Option	Description	Default
provider	LLM provider to use	anthropic
model	Model identifier	claude-sonnet-4-6
apiKeys	Map of provider name to API key	-
mode	Permission mode (default, acceptEdits, plan, dontAsk, bypassPermissions)	default
baseUrl	Custom base URL for API requests	-
indexer.autoIndex	Automatically index codebase on start	true

Development Mode

For active development with hot-reload across all packages:

yarn dev

This runs all packages in watch mode using Turbo, so changes to core automatically rebuild dependent packages.

Running the CLI

# Interactive mode (default)
yarn start

# With a specific prompt
yarn start -- -p "explain this code"

# Non-interactive / print mode
yarn start -- --print "list all files"

# Resume a previous conversation
yarn start -- --continue

# Use a different model
yarn start -- -m gpt-4o -p openai

VS Code Extension

Build the extension

cd packages/vscode-extension
npm run build

Launch in VS Code

Open the packages/vscode-extension folder in VS Code and press F5 to launch the Extension Development Host.

Configure settings

Open VS Code Settings and search for cdoing to set your provider, API key, and permission mode.

Tip

Use Cmd+Shift+L to open the Cdoing Agent editor panel alongside your code.