cscsoftware avatar

Aidex

cscsoftware/aidex

AiDex gives your AI assistant a persistent index across sessions. Instead of grepping and dumping entire files into context, you get 33 tools for identifier search, file signatures, semantic search over code and docs, and cross-project queries. The semantic layer runs local embeddings with optional LLM reranking. Beyond search, it handles task backlogs with scheduling, session notes that survive chat resets, HTTP log ingestion from any running app, and LLM-optimized screenshots. The interactive Viewer shows file trees, logs, and search results in real time. If you're spending tokens on git diffs and directory listings every conversation, this replaces that workflow with structured lookups and memory.

GitHub stars
35
tools
29
transport
STDIO
last updated
Feb 2, 2026

Tools

29 tools

Public tool metadata for what this MCP can expose to an agent.

aidex_initIndex a project (creates `.aidex/`)

Index a project (creates `.aidex/`)

No parameter schema in public metadata yet.

aidex_querySearch by term (exact/contains/starts_with)

Search by term (exact/contains/starts_with)

No parameter schema in public metadata yet.

aidex_signatureGet one file's classes + methods

Get one file's classes + methods

No parameter schema in public metadata yet.

aidex_signaturesGet signatures for multiple files (glob)

Get signatures for multiple files (glob)

No parameter schema in public metadata yet.

aidex_updateRe-index a single changed file

Re-index a single changed file

No parameter schema in public metadata yet.

aidex_removeRemove a deleted file from index

Remove a deleted file from index

No parameter schema in public metadata yet.

aidex_summaryProject overview

Project overview

No parameter schema in public metadata yet.

aidex_treeFile tree with statistics

File tree with statistics

No parameter schema in public metadata yet.

aidex_describeAdd documentation to summary

Add documentation to summary

No parameter schema in public metadata yet.

aidex_linkLink another indexed project

Link another indexed project

No parameter schema in public metadata yet.

aidex_unlinkRemove linked project

Remove linked project

No parameter schema in public metadata yet.

aidex_linksList linked projects

List linked projects

No parameter schema in public metadata yet.

aidex_statusIndex statistics

Index statistics

No parameter schema in public metadata yet.

aidex_scanFind indexed projects in directory tree

Find indexed projects in directory tree

No parameter schema in public metadata yet.

aidex_filesList project files by type (code/config/doc/asset)

List project files by type (code/config/doc/asset)

No parameter schema in public metadata yet.

aidex_noteRead/write session notes (persists between sessions)

Read/write session notes (persists between sessions)

No parameter schema in public metadata yet.

aidex_sessionStart session, detect external changes, auto-reindex

Start session, detect external changes, auto-reindex

No parameter schema in public metadata yet.

aidex_viewerOpen interactive project tree in browser

Open interactive project tree in browser

No parameter schema in public metadata yet.

aidex_taskCreate, read, update, delete tasks with priority and tags

Create, read, update, delete tasks with priority and tags

No parameter schema in public metadata yet.

aidex_tasksList and filter tasks by status, priority, or tag

List and filter tasks by status, priority, or tag

No parameter schema in public metadata yet.

aidex_screenshotTake a screenshot (fullscreen, window, region) with optional scale + color reduction

Take a screenshot (fullscreen, window, region) with optional scale + color reduction

No parameter schema in public metadata yet.

aidex_windowsList open windows for screenshot targeting

List open windows for screenshot targeting

No parameter schema in public metadata yet.

aidex_global_initScan directory tree, register all indexed projects in global DB

Scan directory tree, register all indexed projects in global DB

No parameter schema in public metadata yet.

aidex_global_statusList all registered projects with stats

List all registered projects with stats

No parameter schema in public metadata yet.

aidex_global_querySearch terms across ALL registered projects

Search terms across ALL registered projects

No parameter schema in public metadata yet.

aidex_global_signaturesSearch methods/types by name across all projects

Search methods/types by name across all projects

No parameter schema in public metadata yet.

aidex_global_refreshUpdate stats and remove stale projects from global DB

Update stats and remove stale projects from global DB

No parameter schema in public metadata yet.

aidex_global_guidelineStore/retrieve AI guidelines and coding conventions (key-value, global)

Store/retrieve AI guidelines and coding conventions (key-value, global)

No parameter schema in public metadata yet.

aidex_logUniversal log receiver — start HTTP server, query logs, live stream in Viewer

Universal log receiver — start HTTP server, query logs, live stream in Viewer

No parameter schema in public metadata yet.

Sponsors

Readme

AiDex

npm version MIT License Node.js 20+ MCP Server GitHub Discussions

The persistent brain for AI coding agents.

AiDex is an MCP server that gives AI coding assistants a memory, semantic search, and live telemetry — local-first, model-agnostic. Works with any MCP-compatible AI assistant: Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot, and more.

Three Pillars

🧠 Memory — Tasks, notes, and session-notes survive every chat. Auto-logged history, scheduled tasks, cross-session continuity. Your AI knows tomorrow what mattered today.


View the full README on GitHub

Details

Repository
github.com/cscsoftware/aidex
Package
aidex-mcp
Transport
STDIO
Registry
MCP registry, active