debugger-cli 0.1.3

LLM-friendly debugger CLI using the Debug Adapter Protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# Attach Mode Test
# Tests attaching to a running process

name: "C Attach Process Test"
description: "Verifies debugger can attach to a running process and set breakpoints"

setup:
  # Compile attach target
  - shell: "gcc -g tests/fixtures/attach_target.c -o tests/fixtures/test_attach_c"
  # Start target in background and capture PID to file
  # Use timeout to ensure process terminates even if test fails
  - shell: "timeout 30 tests/fixtures/test_attach_c > /tmp/attach_output.txt 2>&1 & echo $! > /tmp/attach_pid.txt"
  # Wait for target to start and print PID
  - shell: "sleep 1"

target:
  # Attach mode uses pid_file field to read PID from setup step
  program: "../fixtures/test_attach_c"
  mode: "attach"
  pid_file: "/tmp/attach_pid.txt"
  adapter: "lldb"

steps:
  # Set breakpoint in running process
  - action: command
    command: "break tests/fixtures/attach_target.c:15"
    expect:
      success: true

  # Continue execution
  - action: command
    command: "continue"

  # Wait for breakpoint hit
  - action: await
    timeout: 10
    expect:
      reason: "breakpoint"
      file: "attach_target.c"
      line: 15