@tinoy/pi-focus-gate

Machine-global focus mode: while it is on, sessions work but cannot touch the desktop.

Packages

Package details

extension

Install @tinoy/pi-focus-gate from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@tinoy/pi-focus-gate

Package: @tinoy/pi-focus-gate
Version: 0.5.4
Published: Oct 18, 2026
Downloads: 671/mo · 49/wk
Author: tinoy
License: MIT
Types: extension
Size: 35.8 KB
Dependencies: 2 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

[!WARNING] Do not install anything here yet.

This is a fast-moving prototype: the interfaces change without notice, and nothing here is stable. Every package in this project is headed for a stable 1.0, but that is still some way off. Install one only if you intend to follow the code and expect breakage.

@tinoy/pi-focus-gate

Machine-global focus mode: while it is on, sessions work but cannot touch the desktop.

pi install npm:@tinoy/pi-focus-gate

What it needs at call time

$XDG_RUNTIME_DIR for the state file and the per-session ledgers; the rule table names AGS, Hyprland, grim and the inject wrapper, and each refusal names the tool it refused.

Registers

no tool

Caveats

No caveat rows declared: this unit's only soft dependency is machine capability, named above, and it refuses by name rather than failing to load.

Dependencies

pi-supplied imports (@earendil-works/pi-coding-agent) are peer dependencies with a * range and are never bundled. Plain dependencies: @tinoy/pi-ext-lib, @tinoy/pi-focus-state.

Licence

MIT — see the repository LICENSE.