Catenary
A bridge between MCP and LSP — giving AI coding assistants IDE-quality code intelligence.
Quick Start
1. Install Catenary
2. Connect your AI Assistant
Claude Code
Gemini CLI
Add to ~/.gemini/settings.json:
Then configure your language servers in ~/.config/catenary/config.toml.
Features
- LSP Multiplexing — Multiple language servers in one instance
- Lazy Loading — Servers start only when needed
- Smart Routing — Automatic language detection by file type
- Full Coverage — Hover, definitions, references, diagnostics, completions, rename, formatting, and more
- File I/O — Read, write, edit files with automatic LSP diagnostics
- Shell Execution — Run commands with configurable allowlists
MCP Tools
| Tool | Description |
|---|---|
hover |
Documentation and type info |
definition |
Go to definition |
lsp_references |
Find all references |
diagnostics |
Errors and warnings |
rename |
Rename with dry-run preview |
completion |
Code completions |
formatting |
Format documents |
read_file |
Read file contents + diagnostics |
write_file |
Write file + diagnostics |
edit_file |
Search-and-replace edit + diagnostics |
list_directory |
List directory contents |
run |
Execute shell commands (allowlist enforced) |
| ... | See all tools |
Documentation
- Install — Setup for Claude Code, Claude Desktop, Gemini CLI
- Config — Configuration reference
- LSPs — Language server setup guides
License
GPL-3.0 — See LICENSE for details.
Commercial licensing available for proprietary use. Contact contact@markwells.dev.