@dbalster/gdb-plugin 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Balster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @dbalster/gdb-plugin
+
+A [Kilo](https://kilo.ai) / OpenCode TypeScript plugin that provides a full GDB/MI debugging interface via GDB's Machine Interface protocol.
+
+## Features
+
+- **30+ debugging tools**: init, load, run, continue, interrupt, step, next, finish, breakpoints, watchpoints, catchpoints, backtrace, locals, evaluate, memory, registers, disassemble, threads, and more
+- **GDB/MI protocol**: Full MI tokenizer/parser with async record handling
+- **State persistence**: Session state saved to `/tmp/kilo-gdb/state.json` across restarts
+- **Process management**: Start, stop, attach, detach, and core dump support
+- **Reverse execution**: record/reverse-step/next/continue/finish
+- **Variable objects**: Create and watch expressions across debugging steps
+
+## Installation
+
+```bash
+npm install -g @dbalster/gdb-plugin
+```
+
+## Usage in Kilo/OpenCode
+
+Copy or symlink `gdb.ts` into your `.kilo/plugins/` directory:
+
+```bash
+mkdir -p ~/project/.kilo/plugins
+cp node_modules/@dbalster/gdb-plugin/dist/gdb.js ~/project/.kilo/plugins/gdb.js
+```
+
+Then reference it in `.kilo/kilo.json`:
+
+```json
+{
+  "plugins": ["./plugins/gdb.js"]
+}
+```
+
+## Tools Provided
+
+| Tool | Description |
+|------|-------------|
+| `gdbInit` | Start GDB with a binary executable |
+| `gdbLoad` | Load a new binary/symbol file |
+| `gdbRun` | Run/restart the debugged program |
+| `gdbContinue` | Continue execution |
+| `gdbInterrupt` | Interrupt the running program |
+| `gdbStep` | Step into next source line |
+| `gdbNext` | Step over next source line |
+| `gdbFinish` | Step out of current function |
+| `gdbBreak` | Set a breakpoint |
+| `gdbBreakpointList` | List all breakpoints |
+| `gdbBreakpointDelete` | Delete breakpoint(s) |
+| `gdbBreakpointEnable` / `gdbBreakpointDisable` | Toggle breakpoints |
+| `gdbBreakpointCondition` | Set/clear breakpoint condition |
+| `gdbWatch` | Set a watchpoint |
+| `gdbCatch` | Set a catchpoint |
+| `gdbBacktrace` | Print call stack |
+| `gdbLocals` | Show local variables |
+| `gdbEvaluate` | Evaluate an expression |
+| `gdbSet` | Set a variable/memory value |
+| `gdbDisplay` / `gdbDisplayList` / `gdbDisplayDelete` / `gdbDisplayUpdate` | Variable objects |
+| `gdbThreads` / `gdbSelectThread` | Thread management |
+| `gdbSelectFrame` | Select stack frame |
+| `gdbDisassemble` | Disassemble code |
+| `gdbRegisters` | Show CPU registers |
+| `gdbStatus` | Session status overview |
+| `gdbArgs` / `gdbCwd` / `gdbEnv` | Program setup |
+| `gdbSignal` | Send a signal |
+| `gdbAttach` / `gdbDetach` | Process attach/detach |
+| `gdbCore` | Generate core dump |
+| `gdbSource` | Source a GDB script |
+| `gdbPstack` | Stack traces for all threads |
+| `gdbRecord` / `gdbReverse` | Reverse execution |
+| `gdbFind` / `gdbMem` | Memory search and dump |
+| `gdbJump` / `gdbReturn` | Execution control flow |
+| `gdbExit` | Terminate GDB session |
+| `gdbRaw` / `gdbInfo` / `gdbExec` | Raw/CLI command access |
+
+## Requirements
+
+- [GDB](https://www.gnu.org/software/gdb/) installed on the system
+- A compiled binary with debug symbols (`-g` flag)
+
+## License
+
+MIT

package/dist/gdb.d.ts

@@ -0,0 +1,3 @@
+import { type Plugin, type PluginInput } from "@kilocode/plugin";
+export default function gdbPlugin(input: PluginInput): ReturnType<Plugin>;
+//# sourceMappingURL=gdb.d.ts.map

package/dist/gdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdb.d.ts","sourceRoot":"","sources":["../gdb.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAQ,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAm1BvE,wBAA8B,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAi6B9E"}