AI 에이전트를 위한 디버거 CLI

Debugger CLI built for AI agents. Fast, token-efficient, no fluff.

왜 필요한가? 에이전트들은 print-디버깅에 토큰을 낭비합니다. 실제 디버거는 변수, 스택, 브레이크포인트 등 정밀한 상태 검사를 최소한의 출력으로 제공하며, 이는 모두 짧은 @ref 핸들러를 통해 이루어집니다.

Vercel의 에이전트-브라우저 CLI에서 영감을 받았습니다. 동일한 @ref 개념을 브라우징 대신 디버깅에 적용했습니다.

Bun이 필요합니다.

bun install --global debug-that

npx skills add theodo-group/debug-that

> dbg launch --brk tsx src/app.ts
Session "default" started (pid 70445)
Paused at ./src/app.ts:0:1
...

# Node.js
dbg launch --brk node app.js
# TypeScript (tsx를 통한 실행)
...

전체 참조

dbg — AI 에이전트를 위한 디버거 CLI
사용법: dbg <명령어> [옵션]
Session:
...

CLI (stateless) --> Unix socket IPC --> Daemon (per session)
|
DebugSession / DapSession
...

데몬은 두 가지 세션 유형을 관리합니다:

DebugSession(CDP) — JavaScript 런타임(Node.js, Bun)용입니다. V8과 JSC 간의 프로토콜 차이를 처리하기 위해 RuntimeAdapter를 사용합니다.DapSession(DAP) — 네이티브 디버거(LLDB 등)용입니다. 디버그 어댑터 프로토콜을 사용하여 stdin/stdout을 통해 디버그 어댑터와 통신합니다.