> ## 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.

# FAQ

> Frequently asked questions about CodeArchitect MCP

## Why Use CodeArchitect MCP?

Saves AI conversations as searchable markdown files. Prevents losing important architectural discussions.

**Benefits:**

* Preserve knowledge as markdown files
* Auto-organized by date
* Searchable with grep/IDE/git
* Zero configuration

## How It Works

**MCP Protocol:** AI assistants call tools via MCP. CodeArchitect MCP exposes `codearchitect_help`, `store_session`, and `get_session` tools.

**Storage:** Sessions saved to `~/.codearchitect/sessions/YYYY-MM-DD/topic-folder/` in your home directory (always). Each session has `summary.md` and `full.md` files.

**Export File Detection:** Automatically detects Cursor/VS Code export files from `~/.codearchitect/exports/`. Supports both Cursor (`.md`) and VS Code (`.json`) formats.

**Topic Extraction:** Auto-extracts topics from conversation (or use explicit topic parameter). Redundant suffixes like "-summary" are automatically removed.

**Token Optimization:** `get_session` supports TOON format for \~40% token reduction when sending to LLMs.

## Usage

**Get Help (Start Here!):**
Just ask your AI: `use codearchitect`

**Store Session (Recommended Workflow):**

1. Export chat from Cursor/VS Code to `~/.codearchitect/exports/`
2. `use codearchitect store_session` - Auto-detects export file and saves it
3. Or: `use codearchitect store_session topic: "authentication implementation"` - Save with topic
4. Or: `use codearchitect store_session exportFilename: "resolve_mcp"` - Match specific export file

**Get Session:**

* `use codearchitect get_session` - List all sessions
* `use codearchitect get_session authentication-implementation` - Get specific session by folder name
* `use codearchitect get_session 2025-11-18` - List sessions from date

**Parameters:**

* `codearchitect_help`: `feature` (optional) - Get help for all features or specific feature
* `store_session`: `conversation` (optional - auto-detects export file), `exportFilename` (optional), `topic` (optional), `format` ("plain" or "messages"), `projectDir` (optional)
* `get_session`: `filename` (optional), `date` (optional), `format` ("json", "toon", or "auto"), `limit` (optional)

## Where Are Sessions Stored?

**Main location (always):** `~/.codearchitect/sessions/YYYY-MM-DD/topic-folder/`

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

**Structure:**

```
~/.codearchitect/sessions/
└── YYYY-MM-DD/
    └── topic-folder-name/
        ├── summary.md    # Quick summary + key points
        └── full.md       # Complete conversation
```

**Export folder:** `~/.codearchitect/exports/`

* Export chats here for automatic detection
* Supports both Cursor (`.md`) and VS Code (`.json`) formats

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

* Only if `projectDir` parameter is explicitly provided
* Saves to both main folder AND project folder

## Finding Sessions

Sessions are organized in topic-named folders:

* Browse: `~/.codearchitect/sessions/YYYY-MM-DD/topic-folder/`
* Search: `grep -r "keyword" ~/.codearchitect/sessions/`
* Git: Commit sessions for version control
* Use folder names: Sessions are stored by topic, making them easy to find

## Technical

**Tech Stack:** TypeScript, Node.js 18+, MCP SDK

**License:** CC-BY-NC-4.0 (free for non-commercial use)

**Status:** Production-ready. Actively developed.

## Getting Help

* [Troubleshooting](/troubleshooting)
* [GitHub Issues](https://github.com/tairqaldy/codearchitect-mcp/issues)
* [Telegram](https://t.me/tairqaldy)