# APP-4902 - window-scoped background focus suppression

Субагент APP-4902 - window-scoped background focus suppression для Claude Code исправляет подавление фокуса окон Warp во время фоновой computer-use сессии.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 720 у репозитория
- Автор: dominikmartn
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Обновлён: 2026-11-10
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/app-4902-window-scoped-background-focus-suppression

## Что делает

Субагент задаёт исправление для macOS-сценария, где computer-use управляет окном Warp в фоне. Он сужает подавление событий фокуса до перехода к конкретному целевому окну, чтобы пользователь мог активировать другие окна Warp.

Внутри описаны изменения для per-PID event taps, activation primer, `ActiveSession` и `TapContext`. События фокуса типов `13`, `19` и `20` отбрасываются только при совпадении window identity; события другого окна, без достоверного identity и события целевого процесса проходят дальше. Сессии хранят состояние отдельно, а teardown сохраняет восстановление прежнего фокуса. Сценарий рассчитан на macOS и компьютерное управление Warp.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/APP-4902---window-scoped-background-focus-suppression.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/APP-4902---window-scoped-background-focus-suppression.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/APP-4902---window-scoped-background-focus-suppression.md` — Cursor понимает и .claude/agents/

## Когда брать
- подавить активацию целевого фонового окна Warp
- сохранить ручной фокус на другом окне Warp
- изолировать фокус между параллельными computer-use сессиями
- восстановить прежнее окно после завершения сессии
- проверить фильтрацию событий фокуса типов `13`, `19` и `20`

## Примеры запросов агенту
- Реализуй APP-4902 в `crates/computer_use/src/mac/activation.rs`, сохранив текущий порядок event taps и activation primer.
- Добавь тесты для фильтрации событий фокуса по window identity в `crates/computer_use/src/mac/activation_tests.rs`.
- Проверь, что параллельные сессии и owner-scoped teardown не подавляют и не удаляют состояние друг друга.

## Похожие
- [cmux-cua](https://affpapa.org/nevibecode/skills/cmux-cua.md) — скилл · 1200 установок
- [window-management](https://affpapa.org/nevibecode/skills/window-management.md) — скилл · 58 установок
- [argent-macos-app-interact](https://affpapa.org/nevibecode/skills/argent-macos-app-interact.md) — скилл · 1700 установок
- [app-store-preflight-skills](https://affpapa.org/nevibecode/skills/app-store-preflight-skills.md) — скилл · 2200 установок
- [new-mac-app](https://affpapa.org/nevibecode/skills/new-mac-app.md) — скилл · 1000 установок
- [test-mac-app](https://affpapa.org/nevibecode/skills/test-mac-app.md) — скилл · 1000 установок

Из того же набора: [dominikmartn/harp](https://affpapa.org/nevibecode/by/dominikmartn/harp.md) — 62 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
