> ## Documentation Index
> Fetch the complete documentation index at: https://codearchitect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CodeArchitect MCP Docs

> Never let AI ruin your codebase again - Context augmentation for agents

CodeArchitect MCP gives coding agents deep system design intelligence. It increases context window and reduces AI hallucinations by providing agents with structured chat storage and workflow assistance, decreasing token usage of most coding agents by at least 40%.

<Card title="Get Started" icon="rocket" href="/integrations/codearchitect-mcp" horizontal>
  Install CodeArchitect MCP and configure it for your coding agent in minutes.
</Card>

## Start Using CodeArchitect - It's That Easy!

After installation, simply ask your AI assistant:

```bash theme={null}
use codearchitect
```

This will show you all available features and how to use them. **That's it!** No complex commands to remember.

### Example Prompts

**Get help:**

```bash theme={null}
use codearchitect
```

**Save a conversation (recommended workflow):**

1. Export chat from Cursor/VS Code to `~/.codearchitect/exports/`
2. Say: `use codearchitect store_session`
3. Tool auto-detects export file and saves it

**Save with a specific topic:**

```bash theme={null}
use codearchitect store_session topic: "authentication implementation"
```

**Save to project folder too:**

```bash theme={null}
use codearchitect store_session projectDir: "/path/to/project"
```

**Retrieve a saved session:**

```bash theme={null}
use codearchitect get_session
```

**Get a specific session:**

```bash theme={null}
use codearchitect get_session authentication-implementation
```

**Search across sessions:**

```bash theme={null}
use codearchitect search_session "authentication"
```

**Search with date filter:**

```bash theme={null}
use codearchitect search_session "database" date: "2025-01-20"
```

### Storage Locations

**Main location (always):** `~/.codearchitect/sessions/`

* Windows: `C:\Users\YourName\.codearchitect\sessions\`
* Linux/Mac: `~/.codearchitect/sessions/`

**Export folder (for auto-detection):** `~/.codearchitect/exports/`

* Export chats here for automatic detection

**Optional project folder:** `project/.codearchitect/sessions/`

* Only if `projectDir` parameter is specified

### Folder Structure

Sessions are automatically organized in readable folders:

```
~/.codearchitect/sessions/
└── 2025-11-18/
    ├── authentication-implementation/
    │   ├── summary.md          # Quick summary + key points
    │   └── full.md             # Complete conversation
    └── database-migration/
        ├── summary.md
        └── full.md
```

## Why CodeArchitect MCP?

Solves the problem of **losing valuable AI conversations**. Important discussions with AI assistants often disappear, especially during system design and architecture work.

<CardGroup cols={2}>
  <Card title="Preserve Knowledge" icon="floppy-disk">
    Save conversations as searchable markdown files
  </Card>

  <Card title="Organize Thoughts" icon="folder-tree">
    Auto-organized by date and topic folders
  </Card>

  <Card title="Searchable" icon="magnifying-glass">
    Search with grep, IDE, or git
  </Card>

  <Card title="Zero Configuration" icon="rocket">
    Works out of the box
  </Card>
</CardGroup>

## Quick Start

<Steps>
  <Step title="Install">
    ```bash theme={null}
    npm install -g codearchitect-mcp
    ```
  </Step>

  <Step title="Configure">
    See [Installation Guide](/integrations/codearchitect-mcp) for your IDE (Cursor, VS Code, Claude Desktop, Windsurf, Continue.dev, Cline).
  </Step>

  <Step title="Start Using">
    Just say:

    ```bash theme={null}
    use codearchitect
    ```

    Your AI assistant will show you everything you can do!
  </Step>
</Steps>

## Current Features (v0.1.8)

* ✅ **`codearchitect_help`** - Discover available features with `use codearchitect`
* ✅ **Session Storage** - Save AI conversations in topic-named folders (summary.md + full.md)
* ✅ **Session Retrieval** - Get and list stored sessions with TOON format support (\~40% token reduction)
* ✅ **Session Search** - Full-text search across all sessions with relevance scoring and context snippets
* ✅ **Auto-Organization** - Organized by date in readable topic folders
* ✅ **Smart Topics** - Extracts topics from conversations with redundant suffix removal
* ✅ **Automatic Export Detection** - Auto-detects Cursor/VS Code export files from `~/.codearchitect/exports/`
* ✅ **VS Code JSON Support** - Full support for VS Code's JSON export format
* ✅ **Export Filename Matching** - Match specific export files by pattern
* ✅ **Reliable Storage** - Always saves to `~/.codearchitect/sessions/` (home directory)
* ✅ **Optional Project Save** - Optionally save to project folder with `projectDir` parameter
* ✅ **Token Optimization** - TOON format reduces token usage by \~40% for LLM interactions
* ✅ **Date Filtering** - Filter search results by specific date or date range
* ✅ **Result Limiting** - Limit number of search results returned

## Roadmap

* 🔜 **Session Management** - Delete, export sessions
* 🔜 **Architecture Tools** - Analyze, document, review designs
* 🔜 **Workflow Tools** - Track decisions, manage tech debt

See [Tools & Features](/tools-features) for details.

## Links

* **📦 npm**: [codearchitect-mcp](https://www.npmjs.com/package/codearchitect-mcp)
* **💻 GitHub**: [tairqaldy/codearchitect-mcp](https://github.com/tairqaldy/codearchitect-mcp)
* **👨‍💻 Author**: [Tair Kaldybayev](https://tairkaldybayev.link/)