{
  "id": "page:docs-harness-features-backlog-gaps-tools-capabilities-gap-tools-036",
  "_kind": "Page",
  "_file": "wiki/docs/harness-features-backlog/gaps/tools-capabilities/gap-tools-036.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/harness-features-backlog/gaps/tools-capabilities/GAP-TOOLS-036.md",
    "sourceKind": "repo-docs",
    "title": "GAP-TOOLS-036: Bash Background Execution",
    "displayName": "GAP-TOOLS-036: Bash Background Execution",
    "slug": "docs/harness-features-backlog/gaps/tools-capabilities/gap-tools-036",
    "articlePath": "wiki/docs/harness-features-backlog/gaps/tools-capabilities/GAP-TOOLS-036.md",
    "article": "\n# GAP-TOOLS-036: Bash Background Execution\n\n| Field | Value |\n|-------|-------|\n| Category | tools-capabilities |\n| Priority | Medium |\n| Effort | S |\n| Status | Missing |\n\n## Description\nAdd background execution support and description param to babysitter's `bash`\nagentic tool to match CC's BashTool feature set.\n\n## Current State\nBabysitter's `bash` tool spawns a child process synchronously (waits for completion).\nHas `env` and `cwd` params that CC lacks. Missing `run_in_background` and `description`.\n\nCC's BashTool params: `command`, `description` (required human-readable task summary),\n`timeout`, `run_in_background` (boolean -- runs command in background, returns task ID,\nnotifies on completion).\n\n## Target State\nAdd to the `bash` agentic tool:\n\n- **`run_in_background`**: Boolean. When true, spawn the process and return immediately\n  with a task/effect ID. Completion notification via journal event or callback. The Pi\n  session continues executing while the command runs.\n- **`description`**: String. Human-readable description of what the command does. Used\n  for logging, embedded SDK dashboard display, and permission prompts.\n\nBackground execution requires:\n- Tracking background processes by ID\n- Collecting stdout/stderr asynchronously\n- Delivering completion notification back to the session\n- Cleanup on session termination\n\n## Dependencies\n- [GAP-TOOLS-030](GAP-TOOLS-030.md) -- effect cancellation (to cancel background commands)\n\n## Key Files\n| Component | Path |\n|-----------|------|\n| Agentic tools | `packages/sdk/src/harness/agenticTools.ts` |\n| CC BashTool | `src/tools/BashTool/BashTool.tsx` |\n\n## Recommendation\nPhase 2. Medium priority. Background execution is valuable for long-running builds,\ntests, and deployments during orchestration. The `description` param is low-effort\nand should be added regardless.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-harness-features-backlog",
      "to": "page:docs-harness-features-backlog-gaps-tools-capabilities-gap-tools-036",
      "kind": "contains_page"
    }
  ]
}