sense

# Sense: Codebase Understanding for AI Coding Agents Sense is an MCP server that gives AI agents the structural understanding of a codebase that a senior engineer carries in their head. It runs as one Go binary with a local SQLite index — no API keys, no SaaS, no cloud calls. ## When to Use This Skill Use Sense whenever the task depends on understanding code **relationships**, not just reading text: - "Who calls this function?" / "What does this function call?" - "What breaks if I change this signature?" (blast radius) - "Find the implementation of the X pattern" (semantic search) - "What conventions does this project follow?" (e.g., naming, Rails idioms, Go interface patterns) - "Find dead code" - "Show me all routes / handlers / models / controllers" Do NOT use Sense for: - Locating a string literal or log message — plain grep is faster. - Editing code — Sense is read-only by design. ## Setup (one-time per project) ```bash # Install the binary (macOS / Linux): curl -fsSL https://luuuc.github.io/sense/install.sh | sh # In the project root: sense scan # builds the .sense/ index (tree-sitter + embeddings) sense setup # writes .mcp.json + CLAUDE.md routing + hooks ``` After `sense setup`, your AI tool (Claude Code, Cursor, Codex CLI) has Sense's four tools available via MCP. ## Tools | Tool | Capability | |---|---| | `sense_graph` | Symbol relationships — callers, callees, inheritance, tests, dead code | | `sense_search` | Hybrid semantic + keyword search wi...