agent-lsp is an open-source agent harness and orchestrator developed by Blackwell Systems. Built in Go, it bridges AI coding agents and Language Server Protocol (LSP) tooling by providing structured LSP integration, schema awareness, and execution interfaces specifically tuned for agentic workflows.
LSP-Native Tooling — Exposes dozens of structured LSP-backed tools directly to LLM agents. - Multi-Platform Distribution — Distributed via prebuilt binaries, Go toolchains, Scoop buckets, and Winget packages. - Flexible Configuration Merging — Supports custom overlay configurations via the --merge-config flag across auto-detected language servers. - Comprehension Protocol Optimizations — Engineered to maximize agent comprehension across custom tokenization and serialized formats. - Go-Based Execution Engine — Provides a lightweight, high-performance CLI runtime with zero heavy host dependencies.
Use cases
Use Case: Enabling LSP Capabilities in Custom Coding Agents Developers building custom AI coding agents can point their LLMs to agent-lsp to gain precise code navigation, symbol resolution, and diagnostic reporting across multiple programming languages without implementing bespoke LSP client protocols from scratch.
Use Case: Automated Repository Refactoring and Analysis Teams can integrate agent-lsp into terminal pipelines or autonomous CI/CD scripts to orchestrate multi-file refactoring, allowing the driving agent to verify code integrity using native LSP diagnostics.
Use Case: Standardizing Multi-Language Tool Interfaces Engineering teams managing polyglot repositories can use agent-lsp to provide a single unified interface for over 60 development tools and LSP servers, abstracting language-specific toolchain differences.
Who it is for
agent-lsp is built for developers, tool builders, and platform engineers creating terminal-based AI coding agents that need robust, direct access to Language Server Protocol functionality. It is less suited for end users looking for an all-in-one interactive chat GUI or standalone turnkey coding assistant.
Install guide
Installation Install agent-lsp using Go or your platform's package manager: bash # Install via Go go install github.com/blackwell-systems/agent-lsp/cmd/agent-lsp@latest # Or install on Windows via Scoop scoop bucket add blackwell-systems https://github.com/blackwell-systems/agent-lsp scoop install agent-lsp
First Run Verify the installation and check available configurations: bash agent-lsp --help To overlay custom language server configurations onto automatically detected servers, run: bash agent-lsp --merge-config /path/to/custom-config.json
Example Session Start the LSP agent server to expose LSP tooling to your agent environment: bash agent-lsp start --scope all
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Agent Runbook — Agent Runbook is an open-source contract-based multi-agent skill framework developed by KnoxOps. It acts as an orchestrator and compiler that…
Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…