Skip to content

DROOdotFOO/LSPbridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

38 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LSP Bridge

Crates.io Documentation MIT license Build Status Rust

Project Name: LSP Bridge | CLI Tool: lspbridge | Package: lspbridge

Universal bridge for exporting IDE diagnostics to AI assistants.

STATUS: Version 0.3.0 - Build successful, all tests passing

Overview

LSP Bridge is a high-performance diagnostics processing system that bridges the gap between IDEs and AI assistants. It normalizes diagnostics from various language servers into formats optimized for AI consumption while maintaining strict privacy controls.

Key Features

  • Privacy-first design with three configurable levels and pattern-based filtering
  • Multi-language support for Rust, TypeScript, Python, Go, Java, and more
  • AI-optimized output with context-aware formatting
  • High performance with parallel processing, tiered caching, and compression
  • Production-ready with metrics, tracing, circuit breakers, and rate limiting
  • Flexible configuration via TOML with environment-specific profiles

Installation

From Crates.io (Recommended)

cargo install lspbridge

From Source

git clone https://github.com/Hydepwns/LSPbridge
cd LSPbridge
cargo install --path .

New to LSPbridge? Check out EXAMPLES.md for step-by-step tutorials and real-world usage patterns.

IDE Extensions

Install via your IDE's extension manager:

  • VS Code: Search for "LSP Bridge" or run code --install-extension lspbridge
  • Neovim: Add Hydepwns/lspbridge.nvim to your plugin manager
  • Zed: Available in extension registry (coming soon)

Supported Languages

LSP Bridge normalizes diagnostics from the following language servers:

Language LSP Server Status
Rust rust-analyzer Full support
TypeScript/JavaScript typescript-language-server Full support
Python pylsp, pyright Full support
Go gopls Full support
Java jdtls Full support
C/C++ clangd In progress
Ruby solargraph Planned
PHP intelephense Planned

Additional linters supported:

  • ESLint (JavaScript/TypeScript)
  • Clippy (Rust)
  • Ruff (Python)
  • golangci-lint (Go)

Quick Start

# Export all current diagnostics as JSON
lspbridge export --format json --output diagnostics.json

# Export only errors for AI analysis
lspbridge export --format claude --errors-only --include-context

# Watch for diagnostic changes in real-time
lspbridge watch --errors-only --interval 1000

# Query diagnostics with SQL-like syntax
lspbridge query -q "SELECT * FROM diagnostics WHERE severity = 'error'"

# Interactive query mode
lspbridge query --interactive

# Generate AI training data
lspbridge ai-training export training_data.jsonl

Common Workflows

# CI/CD: Check for errors and fail build if found
lspbridge export --errors-only --format json | jq -e '.diagnostics | length == 0'

# Daily report: Export as Markdown with context
lspbridge export --format markdown --include-context > daily-report.md

# AI assistance: Pipe errors to clipboard for Claude
lspbridge export --format claude --errors-only | pbcopy

# Team collaboration: Generate CSV report
lspbridge query -q "SELECT file, COUNT(*) FROM diagnostics GROUP BY file" --format csv

πŸ“– See EXAMPLES.md for comprehensive usage examples and advanced workflows.

Documentation

API Documentation: Full API docs with examples and implementation details:

# Generate and open comprehensive documentation
cargo doc --no-deps --document-private-items --open

# View online at: target/doc/lsp_bridge/index.html

Comprehensive Examples: See EXAMPLES.md for 50+ practical use cases.

Architecture

IDE Extension β†’ Raw LSP Data β†’ Format Converter β†’ Privacy Filter β†’ Export Service β†’ AI Assistant

Running Tests

# Unit tests
cargo test --lib
# Current: 272 passed, 0 failed (100% pass rate)

# Integration tests
cargo test --test integration

# Full test suite with LSP detection
./test_runner.sh

Current Status

Build Status: Successful compilation with zero errors (resolved from 221 initial errors)

Test Coverage: 279/279 tests passing (100% pass rate)

Architecture: Complete and production-ready

  • Core processing pipeline implemented
  • Multi-language support operational
  • Privacy controls in place
  • Performance optimizations active

Ready for Production: All core features implemented and tested

About

Universal bridge for exporting IDE diagnostics to AI assistants. Privacy-first Rust CLI with IDE extensions for VS Code, Neovim, and Zed.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors