Skip to main content
plugin

codealive — Claude Code plugin: what it does, how to install

codealive is a Claude Code plugin for semantic search and architectural Q&A across indexed repositories, helping agents trace service relationships and understand project architecture.

MIT ★ 15 updated 2026-09-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install codealive@claude-community
Open on GitHub

What codealive does

The plugin equips Claude Code with a context engine for large codebases. Instead of inspecting open files alone, the agent searches indexed repositories to trace service calls and usage patterns.

Under the hood, it includes a code exploration subagent and authentication hooks. The engine runs lexical text lookups alongside semantic queries.

An active CodeAlive account or a self-hosted instance via CODEALIVE_BASE_URL is necessary. Without running python setup.py or exporting CODEALIVE_API_KEY, the plugin cannot query the index.

What it helps with

  • trace cross-service dependencies and handler callers
  • run exact regex and string searches across indexed repositories
  • locate error handling patterns across multiple projects
  • answer architectural questions about codebase structure

Example prompts for the agent

  • How is authentication implemented across this repository?
  • Show me who calls this handler and what it depends on.
  • Find the exact regex match for this token parser.

How to install codealive

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community
/plugin install codealive@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about codealive

How to install codealive in Claude Code?

Run both commands in sequence: first add the catalog with /plugin marketplace add anthropics/claude-plugins-community, then install the plugin using /plugin install codealive@claude-community.

What does the codealive plugin do?

It gives Claude Code a context engine to search indexed repositories and trace service dependencies. It also adds an exploration subagent to synthesize answers about your architecture.

How do I configure authentication for codealive?

Run python setup.py to store your API key in the OS credential store. Alternatively, export the CODEALIVE_API_KEY environment variable.

Source text

SKILL.md · MIT
# CodeAlive Skills

Agent skills and Claude Code plugin for [CodeAlive](https://app.codealive.ai) — install via [skills.sh](https://skills.sh/) or as a Claude Code plugin.

## Available Skills

| Skill | Description |
|-------|-------------|
| [codealive-context-engine](skills/codealive-context-engine/) | Semantic code search and AI-powered codebase Q&A across indexed repositories |

## Installation

> **Claude Code users:** the recommended installation method is [Option 2 (Plugin)](#option-2-claude-code-plugin) — it includes the skill plus authentication hooks and a code exploration subagent.

### Option 1: Skills (universal — 30+ agents)

Works with Cursor, GitHub Copilot, Windsurf, Gemini CLI, Codex, Goose, Amp, Roo Code, OpenCode, OpenClaw, and [others](https://agentskills.io/).

```bash
npx skills add CodeAlive-AI/codealive-skills@codealive-context-engine
```

Or copy the `skills/codealive-context-engine` folder into your agent's skills directory:

| Agent | Project scope | User scope |
|-------|--------------|------------|
| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
| GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |
| Codex | `.codex/skills/` | `~/.codex/skills/` |
| Goose | `.goose/skills/` | `~/.config/goose/skills/` |
| Amp | `.agents/skills/` | `~/.config/agents/skills/` |
| Roo Code | `.roo/skills/` | `~/.roo/skills/` |
| OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` |
| OpenClaw | `skills/` | `~/.openclaw/skills/` |

### Option 2: Claude Code Plugin

For Claude Code users, this repository also serves as a plugin marketplace with Claude-specific enhancements.

```
/plugin marketplace add CodeAlive-AI/codealive-skills
/plugin install codealive@codealive-marketplace
```

### Option 3: MCP Server

For deeper integration, install the [CodeAlive MCP server](https://github.com/CodeAlive-AI/codealive-mcp) — it gives your agent direct access to CodeAlive's tools via the Model Context Protocol. The skill and MCP server complement each other: the MCP server provides tool access, the skill teaches the agent how to use it effectively.

### Option 4: Share the Claude Code plugin with another agent

If you already use the Claude Code plugin and want Codex CLI, Gemini CLI, or another skill-aware agent to consume the exact same skill files, install the [plugin bridge](tools/plugin-bridge/) — a tiny `launchd` agent (macOS) or `systemd --user` path unit (Linux) that keeps a symlink from the other agent's skills directory into the plugin's versioned cache. It re-links automatically on `claude plugin update`.

```bash
cd tools/plugin-bridge
./install-macos.sh
```

See [`tools/plugin-bridge/README.md`](tools/plugin-bridge/README.md) for configuration and Linux instructions.

## Setup

After installing the skill, run the interactive setup:

```bash
python setup.py
```

This will ask for your [API key](https://app.codealive.ai/settings/api-keys), verify it, and store it securely in your OS credential store.

### API Key Storage

The API key is resolved in this order:

1. `CODEALIVE_API_KEY` environment variable
2. OS credential store:

| Platform | Store | Manual command |
|----------|-------|----------------|
| macOS | Keychain | `security add-generic-password -a "$USER" -s "codealive-api-key" -w "KEY"` |
| Linux | Secret Service | `secret-tool store --label="CodeAlive API Key" service codealive-api-key` |
| Windows | Credential Manager | `cmdkey /generic:codealive-api-key /user:codealive /pass:"KEY"` |

The key is stored once and shared across all agents on the same machine.

**Self-hosted instance:** set `CODEALIVE_BASE_URL` to your deployment origin, for example `https://codealive.yourcompany.com`. The setup script accepts both `https://host` and `https://host/api`, but the origin form is preferred.

## Usage

Start your agent and ask naturally:

- *"How is authentication implemented?"*
- *"Find the exact regex or string match for this token parser"*
- *"Show me error handling patterns across services"*
- *"Find similar features to guide my implementation"*
- *"Show me who calls this handler and what it depends on"*

No special commands needed — the agent picks up the skill automatically.

To check the installed skill version without authentication or a network request:

```bash
python skills/codealive-context-engine/scripts/get_version.py
```

## License

MIT

© CodeAlive-AI · MIT · CodeAlive-AI/codealive-skills

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open