diff --git a/.gitignore b/.gitignore
index 722d3337..4e25dc00 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,9 @@ dist/
 
 # WASM build output (built locally and in CI)
 ghostty-vt.wasm
+
+# Local-only agent workflows, commands, task notes and worktrees
+.agents/
+.claude/
+.worktrees/
+_tasks/
diff --git a/lib/types.ts b/lib/types.ts
index 4d6eefa2..390f3ae3 100644
--- a/lib/types.ts
+++ b/lib/types.ts
@@ -532,6 +532,7 @@ export const COLORS_STRUCT_SIZE = 12;
  * All color values use 0xRRGGBB format. A value of 0 means "use default".
  */
 export interface GhosttyTerminalConfig {
+  /** Scrollback buffer size in bytes. Passed to Terminal.max_scrollback. */
   scrollbackLimit?: number;
   fgColor?: number;
   bgColor?: number;
@@ -604,7 +605,7 @@ export interface Cursor {
  * Terminal configuration (passed to ghostty_terminal_new_with_config)
  */
 export interface TerminalConfig {
-  scrollback_limit: number; // Number of scrollback lines (default: 10,000)
+  scrollback_limit: number; // Scrollback buffer size in bytes (default: 10,000)
   fg_color: RGB; // Default foreground color
   bg_color: RGB; // Default background color
 }