Skip to main content

​
Current Tools (v0.1.8)

​
codearchitect_help

Discover available features and get usage guidance. Start here! Features:
  • Lists all available features with descriptions
  • Shows usage patterns and examples
  • Provides when-to-use guidance
  • Feature-specific help available
Usage: 
use codearchitect

use codearchitect store_session
See API Reference for details.

​
store_session

Save AI conversation sessions as organized markdown files in topic-named folders. Features:
  • Automatic export file detection - Auto-detects Cursor/VS Code exports from ~/.codearchitect/exports/
  • VS Code JSON support - Full support for VS Code’s complex JSON export format
  • Export filename matching - Match specific export files by pattern
  • Auto-organization by date (~/.codearchitect/sessions/YYYY-MM-DD/topic-folder/)
  • Topic-named folders with summary.md and full.md files
  • Smart topic extraction with redundant suffix removal
  • Always saves to main folder (~/.codearchitect/sessions/)
  • Optional project folder save with projectDir parameter
Usage: 
# Recommended: Export chat first, then:
use codearchitect store_session

use codearchitect store_session topic: "authentication implementation"

use codearchitect store_session exportFilename: "resolve_mcp"
See API Reference for details.

​
get_session

Retrieve stored AI conversation sessions with TOON format support. Features:
  • Get specific session by folder name (e.g., authentication-implementation)
  • List all sessions (optionally filtered by date)
  • ~40% token reduction with TOON format
  • Automatic format selection (auto mode)
  • Support for limiting results
  • Handles both folder-based (v0.1.5+) and legacy flat-file formats
Usage: 
use codearchitect get_session

use codearchitect get_session authentication-implementation

use codearchitect get_session 2025-11-18
See API Reference for details.

​
search_session

Search across all stored sessions using full-text search with relevance scoring. Features:
  • Full-text search - Searches through topics, content, and messages
  • Relevance scoring - Results sorted by relevance (0-1 scale)
  • Context snippets - Shows where matches were found (~150 chars before/after)
  • Date filtering - Filter by specific date or date range
  • Result limiting - Control how many results you get
  • Case-insensitive - Works regardless of case
  • Weighted scoring - Topic matches score higher than content matches
Usage: 
use codearchitect search_session "authentication"

use codearchitect search_session "database design" date: "2025-11-19"

use codearchitect search_session "API" dateFrom: "2025-01-01" dateTo: "2025-01-31"

use codearchitect search_session "test" limit: 10
See API Reference for details.

​
Coming Soon

​
Session Management

  • delete_session - Remove sessions
  • export_sessions - Export in various formats

​
Architecture Tools

  • analyze_architecture - Analyze project structure
  • generate_diagrams - Create architecture diagrams
  • document_system - Auto-generate documentation
  • review_design - Review design decisions
  • suggest_patterns - Suggest design patterns

​
Workflow Tools

  • track_decisions - Track ADRs
  • manage_tech_debt - Track technical debt
  • codebase_insights - Codebase health insights
  • dependency_analysis - Dependency optimization

​
Vision

CodeArchitect MCP is evolving into a comprehensive toolkit for system design and architecture projects, providing coding agents with deep system design intelligence to reduce AI hallucinations and improve capabilities by at least 40%.