Skip to main content
subagent CX Codex

APP-4902 — Claude Code subagent: window focus

APP-4902 - window-scoped background focus suppression is a Claude Code subagent that narrows Warp focus blocking during background computer-use sessions.

AGPL-3.0 ★ 720 updated 2026-11-10

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/APP-4902---window-scoped-background-focus-suppression.md
Open on GitHub

What APP-4902 - window-scoped background focus suppression does

This subagent defines a macOS fix for background computer-use in Warp. It keeps the selected window controllable without raising it, while independent focus changes to other Warp windows continue normally.

The change covers per-PID event taps, the activation primer, ActiveSession, and TapContext. Focus events 13, 19, and 20 are dropped only when their window identity matches the target activation; events for another window, missing identity, or the target-process tap pass through. Each session carries its own activation state, and teardown preserves the existing focus-restoration lifecycle. The scenario uses AppKit, CGEvent, and window-addressing fields.

What it helps with

  • keep a background Warp window controllable
  • let users focus another Warp window during computer-use
  • separate activation state across concurrent sessions
  • restore the previous frontmost window during teardown
  • test filtering for focus events 13, 19, and 20

Example prompts for the agent

  • Implement APP-4902 in crates/computer_use/src/mac/activation.rs while preserving the existing event-tap order and activation primer.
  • Add regression coverage for window-identity focus filtering in crates/computer_use/src/mac/activation_tests.rs.
  • Check that concurrent sessions and owner-scoped teardown keep their activation state isolated.

How to install APP-4902 - window-scoped background focus suppression

Manually: put the files in place

.claude/agents/APP-4902---window-scoped-background-focus-suppression.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about APP-4902 - window-scoped background focus suppression

How do I install APP-4902 - window-scoped background focus suppression in Claude Code?

Add the agent file at .claude/agents/APP-4902---window-scoped-background-focus-suppression.md.

What does APP-4902 - window-scoped background focus suppression do?

It specifies a background computer-use fix that blocks activation only for the target window, allowing normal focus changes to other Warp windows.

What does APP-4902 - window-scoped background focus suppression require?

The described scenario is for macOS computer-use in Warp. It uses AppKit, CGEvent, per-PID event taps, and window-addressing identity.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set62

The whole set →
APP-4901-add-fast-forward-slash-command APP-4901-add-fast-forward-slash-command is a Claude Code subagent that adds /auto-approve to Warp's TUI and toggles approval for one conversation. CX Codex ★ 720repo stars APP-4907 - TUI input focus during agent drafting APP-4907 is a Claude Code subagent that keeps TUI input active while an agent prepares a tool call, then hands focus to an approval card when blocking begins. CX Codex ★ 720repo stars CODE-1902 change TUI log storage CODE-1902 change TUI log storage is a Claude Code subagent that moves TUI logs into a frontend-specific directory while keeping GUI channel filenames. It also fixes /view-logs collection. CX Codex ★ 720repo stars APP-4880 - TUI view-logs slash command APP-4880 - TUI view-logs slash command is a Claude Code subagent that adds a /view-logs TUI command to pack logs into a zip. It prints the absolute path and opens the OS file manager. CX Codex ★ 720repo stars QUALITY-1169-richer-click-drag-annotations QUALITY-1169-richer-click-drag-annotations is a Claude Code subagent that adds click ripples and drag trails to computer-use video recordings on Linux. CX Codex ★ 720repo stars CODE-1895-tui-lrc-typeahead-wiring CODE-1895-tui-lrc-typeahead-wiring is a Claude Code subagent that restores typed input in the TUI after a long-running command ends. It handles shell typeahead at the next prompt. CX Codex ★ 720repo stars APP-4889 - fixed-height expandable toasts with 3-active cap APP-4889 - fixed-height expandable toasts with 3-active cap is a Claude Code subagent specifying toast UI limits for Warp. It caps active toasts at three and makes long messages expandable. CX Codex ★ 720repo stars APP-4878 - fix TUI copy to use native clipboard APP-4878 - fix TUI copy to use native clipboard is a Claude Code subagent that routes local TUI copies to the OS clipboard. SSH sessions use OSC 52. CX Codex ★ 720repo stars

Project sponsors

Companies that keep this analytics open