Cline

Overview

Integrate CodeAlive with Cline - the open-source AI coding agent used by millions of developers. Cline can autonomously create and extend its capabilities through MCP tools. With 30k+ GitHub stars, Cline offers complete transparency and zero vendor lock-in.

Quick install: Run npx @codealive/installer to automatically configure CodeAlive for Cline. See the Installation Guide for details.

Prerequisites

Cline extension installed in VS Code
CodeAlive account with API key (Sign up here)
Indexed repositories in your CodeAlive dashboard

Connecting to CodeAlive

Open Cline Settings

Access Cline’s MCP configuration:

Click on the Cline icon in the VS Code sidebar
Click the settings gear icon
Navigate to “MCP Servers” section

Or use Command Palette:

Cmd/Ctrl+Shift+P → “Cline: Configure MCP Servers”

Add CodeAlive MCP

Configure CodeAlive as an MCP server:

{
  "mcpServers": {
    "codealive": {
      "url": "https://mcp.codealive.ai/api",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Cline’s Unique Feature: Ask Cline to “add a tool” and it will create and install custom MCP servers tailored to your workflow - no manual configuration needed!

Replace YOUR_API_KEY_HERE with your actual CodeAlive API key

Enable MCP in Cline

Ensure MCP is enabled in Cline settings:

{
  "cline.enableMCP": true,
  "cline.mcpAutoConnect": true
}

Restart VS Code

Restart VS Code to ensure all changes take effect

Verify Integration

Test by asking Cline:

“Use CodeAlive to show me all available repositories”
“Search the codebase for authentication logic”
“Analyze the project architecture using CodeAlive”

Configuration Options

Advanced Settings

{
  "mcpServers": {
    "codealive": {
      "url": "https://mcp.codealive.ai/api",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Docker Deployment

Run CodeAlive locally for better performance:

{
  "mcpServers": {
    "codealive": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
        "ghcr.io/codealive-ai/codealive-mcp:main"
      ]
    }
  }
}

Usage Patterns

Autonomous Tasks
Guided Development
Code Review

Let Cline use CodeAlive automatically:

"Refactor the user service to match our microservices pattern"

Cline will:
1. Use CodeAlive to find existing patterns
2. Analyze the current implementation
3. Generate refactored code
4. Update related files

Direct Cline to use CodeAlive:

"Use CodeAlive to find all payment processing code,
then add retry logic following our existing patterns"

Have Cline review code with context:

"Use CodeAlive to review this PR for consistency
with our codebase conventions"

Cline Rules Configuration

Create .cline/rules.md in your project root:

# CodeAlive Integration Rules

## Always Use CodeAlive For:
- Finding existing implementations before writing new code
- Understanding project architecture and patterns
- Locating all files that might be affected by changes
- Searching for similar code patterns

## Code Generation Guidelines:
- Match the style found via CodeAlive search
- Follow conventions discovered in the codebase
- Reuse existing utilities and helpers
- Maintain consistency with existing patterns

## Before Making Changes:
1. Search with CodeAlive for related code
2. Analyze existing patterns
3. Consider impact on other parts of the system
4. Follow established conventions

Advanced Features

Task Planning

Configure Cline to use CodeAlive for planning:

{
  "cline.planning": {
    "enabled": true,
    "useCodeAlive": true,
    "steps": [
      "Search for similar implementations",
      "Analyze existing patterns",
      "Plan changes based on findings",
      "Execute implementation"
    ]
  }
}

Custom Commands

Create Cline commands that leverage CodeAlive:

{
  "cline.customCommands": [
    {
      "name": "Analyze Architecture",
      "command": "Use CodeAlive to analyze and explain the project architecture"
    },
    {
      "name": "Find Security Issues",
      "command": "Use CodeAlive to search for potential security vulnerabilities"
    },
    {
      "name": "Generate Tests",
      "command": "Use CodeAlive to find the code, then generate comprehensive tests"
    }
  ]
}

Model Configuration

Optimize Cline’s model usage with CodeAlive:

{
  "cline.apiProvider": "anthropic",
  "cline.apiModel": "claude-3-opus-20240229",
  "cline.contextStrategy": "codealive-first",
  "cline.maxContextTokens": 100000
}

Workspace Settings

Project-Specific Configuration

.vscode/settings.json:

{
  "mcpServers": {
    "codealive": {
      "type": "http",
      "url": "https://mcp.codealive.ai/api",
      "headers": {
        "Authorization": "Bearer ${env:CODEALIVE_API_KEY}"
      },
      "repositories": ["backend", "frontend", "shared"]
    }
  },
  "cline.autoDetectTasks": true
}

Team Collaboration

Share configuration without exposing API keys:

Add to .vscode/settings.json:

{
  "cline.mcpServers.codealive.headers.Authorization": "Bearer ${env:CODEALIVE_API_KEY}"
}

Team members set environment variable:

export CODEALIVE_API_KEY="their_api_key"

Performance Optimization

Caching

Enable caching for repeated queries:

{
  "cline.cache": {
    "enabled": true,
    "codealiveQueries": true,
    "ttl": 3600
  }
}

Context Management

Optimize context window usage:

{
  "cline.contextOptimization": {
    "useCodeAliveFirst": true,
    "summarizeContext": true,
    "maxFilesPerRequest": 10
  }
}

Parallel Processing

Enable parallel CodeAlive queries:

{
  "cline.parallel": {
    "enabled": true,
    "maxConcurrent": 3
  }
}

Troubleshooting

Cline not detecting CodeAlive

Solutions:

Check MCP is enabled in Cline settings
Verify MCP server configuration
Restart VS Code completely
Check Cline output panel for errors

Slow autonomous operations

Solutions:

Use Docker for local deployment
Limit repository scope in searches
Enable caching
Optimize context window usage

Authentication errors

Solutions:

Regenerate API key
Check Bearer token format
Verify environment variables
Test connection manually

Context window exceeded

Solutions:

Enable context optimization
Use CodeAlive for large file searches
Limit files per request
Use summarization features

For more solutions, see the Troubleshooting Guide.

Best Practices

Let Cline Plan

Allow Cline to use CodeAlive for task planning

Review Changes

Always review Cline’s changes in context

Iterative Development

Use CodeAlive to verify changes match patterns

Safety First

Test Cline’s changes in development first

Tips for Effective Use

Prompting Strategies

Good Prompts:

"Use CodeAlive to find our API endpoint patterns,
then create a new user profile endpoint"

"Search for our error handling patterns with CodeAlive,
then improve error handling in the payment service"

Avoid:

"Create a new endpoint" (too vague, won't use context)
"Fix the bug" (doesn't leverage CodeAlive)

Task Delegation

Let Cline handle complex multi-file operations:

"Use CodeAlive to find all references to the old User model,
then update them to use the new UserProfile model"

Instruct Your Agent

Connecting CodeAlive makes its tools available, but the agent may still default to its built-in search. For reliable results, add a short instruction in the agent’s native format telling it to prefer semantic_search and grep_search when exploring indexed code. See Instructing Coding Agents.

Getting Started

Features

Model Context Protocol

Agent Skills & Plugins

Instructing Agents

Overview

Prerequisites

Connecting to CodeAlive

Configuration Options

Advanced Settings

Docker Deployment

Usage Patterns

Cline Rules Configuration

Advanced Features

Task Planning

Custom Commands

Model Configuration

Workspace Settings

Project-Specific Configuration

Team Collaboration

Performance Optimization

Troubleshooting

Best Practices

Let Cline Plan

Review Changes

Iterative Development

Safety First

Tips for Effective Use

Prompting Strategies

Task Delegation

Instruct Your Agent

​Overview

​Prerequisites

​Connecting to CodeAlive

​Configuration Options

​Advanced Settings

​Docker Deployment

​Usage Patterns

​Cline Rules Configuration

​Advanced Features

​Task Planning

​Custom Commands

​Model Configuration

​Workspace Settings

​Project-Specific Configuration

​Team Collaboration

​Performance Optimization

​Troubleshooting

​Best Practices

Let Cline Plan

Review Changes

Iterative Development

Safety First

​Tips for Effective Use

​Prompting Strategies

​Task Delegation

​Related Resources

​Instruct Your Agent

Overview

Prerequisites

Connecting to CodeAlive

Configuration Options

Advanced Settings

Docker Deployment

Usage Patterns

Cline Rules Configuration

Advanced Features

Task Planning

Custom Commands

Model Configuration

Workspace Settings

Project-Specific Configuration

Team Collaboration

Performance Optimization

Troubleshooting

Best Practices

Tips for Effective Use

Prompting Strategies

Task Delegation

Related Resources

Instruct Your Agent