Repo brief: vadimcn/codelldb

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T17:49:39.465Z · commit 5c21c4320629

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 2w ago
• 2 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

CodeLLDB is a VSCode debugger extension that integrates the LLDB debugger (Apple's debugger infrastructure) to provide native code debugging for C++, Rust, and other compiled languages. It enables breakpoints, watchpoints, disassembly viewing, Python scripting for custom visualizers, and hardware-level stepping—all within VSCode rather than requiring Xcode or GDB. Monorepo (Cargo workspace) split into: src/adapter-protocol/ (Debug Adapter Protocol wire format), src/codelldb/ (main Rust extension entry point), src/lldb/ (LLDB C++ bindings), src/lldb-stub/ (stub for offline builds), and adapter/scripts/ (Python LLDB scripting layer with codelldb/api.py as the primary handler).…

Start here

Open these first:

• extension/main.ts — VSCode extension entry point that initializes the debugger adapter and manages the debug session lifecycle.
• Cargo.toml — Workspace configuration defining all Rust crate members including the core adapter, LLDB bindings, and protocol…
• CMakeLists.txt — Root build configuration orchestrating compilation of C++/Rust adapter, LLDB integration, and extension packaging.
• adapter/CMakeLists.txt — Core adapter build configuration that compiles the LLDB-based debugging backend and Python scripting support.
• extension/vibeDebug.ts — Primary debug client implementation bridging VSCode DAP with the LLDB adapter backend.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone and build: git clone https://github.com/vadimcn/codelldb.git && cd codelldb. Install Rust (1.56+ implied by workspace), Python 3, and LLDB headers. Run cargo build --release (configured in Cargo.toml with `d…

Daily commands:

No traditional dev server. Build with cargo build --release, then install into VSCode as an extension. For testing: run the VSCode instance with the extension loaded via .vscode/launch.json (press F5 in VSCode after…

…shortened for this brief.

Key cautions & unknowns

• Small team — 2 contributors active in recent commits
• Single-maintainer risk — top contributor 99% of recent commits
• LLDB version coupling: The extension is tightly bound to LLDB's binary interface; upgrading LLDB on the host can break breakpoint hit detection. Python environment: adapter/scripts/ must run under the…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.