Skip to main content
Glama
Sign In
symapse

symapse

by atobouh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Symapse

Architectural awareness engine for AI coding agents

Install

npm install -g symapse

Requires Node.js 22+. No dependencies. Zero config.

Related MCP server: codebase-rag

Quick Start

# Index your project
symapse index /path/to/repo

# Start the MCP server (for OpenCode/Cursor/Claude integration)
symapse mcp /path/to/repo

# Query from the terminal
symapse_ask "add notification system"
symapse_find login
symapse_map "direct login after payment"
symapse_audit 10
symapse_health

# Live coding awareness — start watching for collisions, breaks, and dead code
symapse_health --watch

OpenCode Integration

Install Symapse first:

npm install -g symapse

Add to your project's opencode.json:

{
  "mcp": {
    "symapse": {
      "type": "local",
      "command": ["npx", "symapse", "mcp", "."],
      "enabled": true
    }
  }
}

Create an AGENTS.md in your project root with:

## RULE 1: Always check Symapse first

| Instead of... | Use... |
|---|---|
| Reading files for architecture | `symapse_map` |
| Grepping for symbols | `symapse_find` |
| Guessing where code goes | `symapse_ask` |
| Finding dead code or duplicates | `symapse_audit` |
| Re-indexing or checking status | `symapse_health` |

First action every session: `symapse_ask "<request>"`. If it returns questions, ASK them.
If Symapse doesn't answer your question, read files.

Tools

Tool

Question it answers

symapse_ask

What should I know before working on X?

symapse_find

Where is X and what does it touch?

symapse_map

Show me the shape of this repo / feature

symapse_audit

What's wrong, unused, or duplicated?

symapse_diff

After changes: what did I affect? What did watch detect?

symapse_health

What's the state of the index? Watch mode

Temporal workflow:

  • Before coding: symapse_ask → symapse_map → symapse_find

  • During coding: symapse_health --watch

  • After each edit: symapse_diff

  • Maintenance: symapse_audit | symapse_health

Supported Languages

JavaScript, TypeScript, Python, Go, Rust, C#, PHP, Ruby, Lua, and C.

How It Works

  1. Index — walks the repo, extracts functions/classes/methods with regex parsers, builds call and import edges

  2. Store — normalized SQLite schema, incremental by mtime + engine version

  3. Expose — CLI, REST API, and MCP over stdio. All share the same engine.

Self-Improving

Symapse learns from agent behavior across sessions without any user involvement:

  • Session coherence — biases context toward the subsystem the agent is already exploring

  • Usage signals — logs which symbols agents actually drill into

  • Workflow memory — auto-detects repeated symbol sequences across sessions

  • Intent classification — routes config/docs questions away from source code exploration

Architecture

packages/
  engine/   — regex-based parser, call graph, all analysis tools
  db/       — SQLite persistence with incremental indexing
  mcp/      — MCP protocol server (JSON-RPC over stdio)
apps/
  cli/      — command-line entry point
  api/      — HTTP API server + web dashboard
  web/      — terminal-style web UI

License

AGPL-3.0

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Resources

Related MCP Connectors

Related MCP Servers

  • Semantic Code Search MCP Server

    Semantic Code Search MCPofficial

    elastic
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI coding agents with structured access to indexed codebases via semantic search, symbol analysis, and file reading tools.
    13
    Server Side Public , v 1

  • codebase-rag

    Ar-maan05
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
    3
    MIT

  • mcp-intelligence-context

    LeoChimal09
    F
    license
    A
    quality
    C
    maintenance
    Provides codebase indexing and retrieval tools that give AI agents token-efficient, query-relevant context packages (symbols, imports, and dependencies) instead of scanning entire repositories.
    6
    -