dapi

Let your AI agent debug like a human developer.

dapi ships two things:

• An agent skill — teaches your AI agent when to reach for the debugger, how to form a hypothesis, and how to confirm it with a single eval. Install once, works on every project.
• The dapi CLI — a stateless CLI wrapper around the Debug Adapter Protocol (DAP). Set breakpoints, inspect runtime state, attach to running servers by PID — no IDE, no restart, no guesswork.

Every stop returns auto-context: location + source snippet + locals + stack + output in one shot. No follow-up calls needed.

Supports Python, Go, JavaScript/TypeScript, Rust, C, and C++.

---

Install the Skill

npx skills install anuk909/dapi

---

Install the CLI

npm install -g dapi-cli

Or zero-install — no setup needed:

npx -y dapi-cli start app.py --break app.py:25

Requires Node.js >= 18.

---

Quick Start

Debug a script

dapi start app.py --break app.py:25
# → paused at calculate() · app.py:25 [breakpoint]
#   Locals, stack, source snippet — all returned automatically

dapi eval "type(data[0]['age'])"   # confirm your hypothesis
dapi continue                      # next breakpoint
dapi close

Attach to a running server

ps aux | grep uvicorn
dapi attach --pid 12345 --break routes.py:42
curl localhost:8000/api/endpoint   # trigger the code path
dapi continue                      # waits for breakpoint hit
dapi eval "request.body"
dapi close                         # detaches, server keeps running

---

Commands

Command	Description
start <script>	Start a debug session
attach --pid <PID>	Attach to a running process by PID
attach [host:]port	Attach to an existing debug server
step [over|into|out]	Step (default: over)
continue	Resume / wait for next breakpoint
context	Re-fetch auto-context without stepping
eval <expression>	Evaluate in current frame
vars	List local variables
stack	Show call stack
output	Drain buffered stdout/stderr
break <file:line[:cond]>	Add breakpoint mid-session
status	Show session state
close	End the debug session

See docs/cli-reference.md for all flags and multi-session usage.

---

Supported Languages

Language	Extension	Adapter	Setup
Python	.py	debugpy	auto-installed on attach --pid
JavaScript/TypeScript	.js .ts	js-debug	Auto-installed on first use
Go	.go	Delve	go install ...dlv@latest
Rust/C/C++	.rs .c .cpp	CodeLLDB	CODELLDB_PATH env var

See docs/languages.md for language-specific setup details.

---

Credits

dapi is based on JoaquinCampo/agent-debugger (multi-language DAP support, attach by PID) and incorporates design ideas from AlmogBaku/debug-skill (auto-context, output buffering, multi-session).