Skip to content

feat(pi-subagents): add global background default - #613

Open
wolfgangmeyers wants to merge 1 commit into
gotgenes:mainfrom
wolfgangmeyers:wolfgang/pi-subagents-background-default
Open

feat(pi-subagents): add global background default#613
wolfgangmeyers wants to merge 1 commit into
gotgenes:mainfrom
wolfgangmeyers:wolfgang/pi-subagents-background-default

Conversation

@wolfgangmeyers

Copy link
Copy Markdown

Summary

Adds the documented defaultRunInBackground global setting in ~/.pi/agent/subagents.json.
When set to true, it makes root subagent calls that omit run_in_background launch in the background.

Explicit run_in_background: false still launches in the foreground.
Explicit agent-frontmatter behavior continues to win over the global fallback.
Nested child calls remain foreground by default, and forked root sessions still receive the global default.
The service adapter is unchanged.

Validation

  • mise exec pnpm@11.5.2 -- pnpm --filter @gotgenes/pi-subagents run check
  • mise exec pnpm@11.5.2 -- pnpm --filter @gotgenes/pi-subagents test — 64 files, 1007 tests passed
  • mise exec pnpm@11.5.2 -- pnpm --filter @gotgenes/pi-subagents run lint
  • git diff --check

Numeric coverage is not available in this package because it has no coverage script or Vitest coverage provider, and @vitest/coverage-v8 is not installed.
The focused behavioral tests cover the global true/false defaults, explicit foreground override, agent-frontmatter precedence, nested-child non-regression, and forked-root behavior.

@wolfgangmeyers
wolfgangmeyers force-pushed the wolfgang/pi-subagents-background-default branch from f4d8790 to 45ff8ff Compare July 18, 2026 00:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant