> For the complete documentation index, see [llms.txt](https://docs.bito.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bito.ai/ai-architect/quick-mcp-integration-with-ai-coding-agents/bitos-ai-architect-plugin-for-claude-code.md).

# Bito's AI Architect plugin for Claude Code

Bito's AI Architect plugin brings cross-repository intelligence to Claude Code. Search code, explore dependencies, analyze architecture, and discover patterns across all your organization's repositories. Use it to build implementation plans, write requirements documents, diagnose production issues, and understand complex codebases.

It enables users to explore and understand any codebase — from high-level architecture to line-level code traces — calibrated for multiple personas (Developer, EM, PM, VP, CTO).

**Key capabilities:**

* Deep codebase exploration across multiple repositories
* AI-powered architecture analysis and documentation
* Production incident triage with blast radius mapping
* Feature planning grounded in real system context

## Installation

#### Step 1: Add the marketplace

Run this command in Claude Code:

```bash
/plugin marketplace add gitbito/claude-plugins
```

#### Step 2: Install the plugin

```bash
/plugin install bito-ai-architect@bito-claude-plugins
```

#### Step 3: Configure your credentials

Run the interactive setup:

```bash
/bito-ai-architect:bito-setup
```

This command guides you through configuring your workspace ID, bearer token, and email.

**Alternative: manual configuration**

Set these environment variables manually:

```bash
export BITO_WORKSPACE_ID="your-workspace-id"
export BITO_MCP_TOKEN="your-bearer-token"
export BITO_EMAIL="your-email@company.com"
```

After configuration, restart Claude Code and run `/mcp` to verify the server is connected.

## Available commands

Once installed, access these slash commands in Claude Code:

| Command                                | Description                                                                                                                                                                                                                     |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/bito-ai-architect:bito-setup`        | Configure credentials interactively                                                                                                                                                                                             |
| `/bito-ai-architect:codebase-explorer` | Explore and understand any codebase from high-level architecture to line-level code traces. Uses "The One Test" methodology with a 4-phase exploration workflow calibrated for different personas (Developer, EM, PM, VP, CTO). |
| `/bito-ai-architect:feature-plan`      | Build a detailed implementation plan for complex features with cross-repo context                                                                                                                                               |
| `/bito-ai-architect:prd`               | Write a Product Requirements Document grounded in real system context                                                                                                                                                           |
| `/bito-ai-architect:trd`               | Produce a Technical Requirements Document by analyzing existing architecture                                                                                                                                                    |
| `/bito-ai-architect:production-triage` | Diagnose production incidents with cross-repo context and blast radius mapping                                                                                                                                                  |
| `/bito-ai-architect:epic-to-plan`      | Convert an approved epic or PRD into a complete, sprint-ready implementation plan                                                                                                                                               |
| `/bito-ai-architect:feasibility`       | Produce a go/no-go feasibility and impact analysis before committing to implementation                                                                                                                                          |
| `/bito-ai-architect:scope-to-plan`     | Convert any approved work item into a complete, sprint-ready implementation plan                                                                                                                                                |
| `/bito-ai-architect:spike`             | Conduct a structured technical investigation when the team doesn't know enough to plan                                                                                                                                          |

## Getting started

#### Explore a codebase

Use the codebase explorer to understand any repository:

```bash
/bito-ai-architect:codebase-explorer
```

The explorer uses a 4-phase workflow to analyze architecture, dependencies, and code patterns. Choose your persona (Developer, EM, PM, VP, CTO) to get insights calibrated to your role.

#### Plan a feature

Create an implementation plan with cross-repo context:

```bash
/bito-ai-architect:feature-plan
```

The plugin analyzes your codebase to identify affected components, dependencies, and potential conflicts.

#### Triage production issues

Diagnose incidents across repositories:

```bash
/bito-ai-architect:production-triage
```

Get cross-repo context and blast radius mapping to understand the full impact of production issues.

## GitHub repository

* <https://github.com/gitbito/claude-plugins>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bito.ai/ai-architect/quick-mcp-integration-with-ai-coding-agents/bitos-ai-architect-plugin-for-claude-code.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.