# pi-computer-use | injaneity | Knowledge Base | Instagit

Let Pi control your apps on MacOS & Windows

GitHub Stars: 1.4k

Repository: https://github.com/injaneity/pi-computer-use

---

## Articles

### [Configuring macOS TCC Permissions for Accessibility and Screen Recording in pi-computer-use](/injaneity/pi-computer-use/configuring-mac-os-tcc-permissions-for-accessibility-and-screen-recording)

Learn to configure macOS TCC permissions for Accessibility and Screen Recording in pi-computer-use. Verify and trigger grants programmatically with checkPermissions and registerPermissions.

- Tags: how-to-guide
- Published: 2026-07-16

### [Action Retry Logic When Foreground Fallback Is Enabled in pi-computer-use](/injaneity/pi-computer-use/action-retry-logic-when-foreground-fallback-is-enabled)

Learn how pi-computer-use handles action retry logic with foreground fallback. Discover how background actions automatically retry in the foreground when needed for seamless operation.

- Tags: deep-dive
- Published: 2026-07-16

### [OCR Integration Through read_text for Non-Accessible Text in pi-computer-use](/injaneity/pi-computer-use/ocr-integration-through-read-text-for-non-accessible-text)

Learn OCR integration with read_text in pi-computer-use. Extract text from images and UI elements using screenshots and external OCR for seamless data processing.

- Tags: how-to-guide
- Published: 2026-07-16

### [Browser Management with managed_browser Config in Pi-Computer-Use: Helium vs Chrome Guide](/injaneity/pi-computer-use/browser-management-with-managed-browser-config-helium-vs-chrome)

Master browser management with managed_browser config in Pi-Computer-Use. Learn the Helium vs Chrome differences and optimize your Pi computer setup for efficient browsing.

- Tags: how-to-guide
- Published: 2026-07-16

### [Extension Installation and Platform Setup Flow for Pi Agents in pi-computer-use](/injaneity/pi-computer-use/extension-installation-and-platform-setup-flow-for-pi-agents)

Learn the extension installation and platform setup flow for Pi agents. Discover how `pi install` configures native helpers, permissions, and validates platform parity for seamless UI observation.

- Tags: how-to-guide
- Published: 2026-07-16

### [Native Socket Protocol Version 6 in pi-computer-use: macOS and Windows Transport Layers](/injaneity/pi-computer-use/native-socket-protocol-for-mac-os-and-windows-transport-layers)

Discover how macOS and Windows transport layers in pi-computer-use leverage native socket protocol version 6 for efficient JSON message exchange. Learn more about this powerful connection.

- Tags: internals
- Published: 2026-07-16

### [Bounded Observation Limits and State Eviction Policies in pi-computer-use](/injaneity/pi-computer-use/bounded-observation-limits-and-state-eviction-policies)

Explore bounded observation limits and state eviction policies in pi-computer-use. Learn how the StateStore manages UI observations with FIFO eviction for optimal performance.

- Tags: deep-dive
- Published: 2026-07-16

### [How to Use `search_ui` and `expand_ui` to Query Cached Immutable State in pi-computer-use](/injaneity/pi-computer-use/using-search-ui-and-expand-ui-to-query-cached-immutable-state)

Unlock efficient pi-computer-use querying with search_ui and expand_ui. Learn to access cached immutable state deterministically and expand UI nodes without live screenshots.

- Tags: how-to-guide
- Published: 2026-07-16

### [How the Cursor Overlay Animation Works Without Blocking Action Delivery in pi-computer-use](/injaneity/pi-computer-use/how-cursor-overlay-animation-works-without-blocking-action-delivery)

Discover how pi-computer-use's cursor overlay animation achieves seamless action delivery via a backend flag, native helper dispatch, and a non-modal SwiftUI window for zero interference.

- Tags: internals
- Published: 2026-07-16

### [Platform Parity Invariants in pi‑computer‑use: Ensuring macOS and Windows Backend Consistency](/injaneity/pi-computer-use/platform-parity-invariants-between-mac-os-and-windows-backends)

Discover platform parity invariants in pi-computer-use ensuring macOS and Windows backend consistency. Learn about seven strict invariants for cross-platform behavioral integrity.

- Tags: architecture
- Published: 2026-07-16

### [How Successor Diffs Render Minimal UI Changes versus Full Folded Views in pi-computer-use](/injaneity/pi-computer-use/how-successor-diffs-render-minimal-ui-changes-vs-full-folded-views)

Explore how successor diffs in pi-computer-use display minimal UI changes compared to full folded views for efficient updates.

- Tags: deep-dive
- Published: 2026-07-16

### [How to Handle Stale Epoch Errors from Concurrent Mutations in pi-computer-use](/injaneity/pi-computer-use/how-to-handle-stale-epoch-errors-from-concurrent-mutations)

Learn how to handle stale epoch errors from concurrent mutations in pi-computer-use. Implement the catch-refresh-retry pattern to ensure state consistency.

- Tags: how-to-guide
- Published: 2026-07-16

### [Understanding worked/didnt/unknown Action Outcomes and Verification in pi-computer-use](/injaneity/pi-computer-use/understanding-worked-didnt-unknown-action-outcomes-and-verification)

Learn how pi computer use defines worked didnt and unknown action outcomes using platform feedback and verification. Understand UI interaction results efficiently.

- Tags: deep-dive
- Published: 2026-07-16

### [How pi-computer-use Integrates Browser Pages via Chrome DevTools Protocol (CDP) as UI Roots](/injaneity/pi-computer-use/how-browser-pages-integrated-via-chrome-devtools-protocol-as-roots)

Learn how pi-computer-use uses Chrome DevTools Protocol CDP to integrate browser tabs as UI roots for automated interaction bypassing accessibility APIs.

- Tags: how-to-guide
- Published: 2026-07-16

### [Architecture Differences Between macOS AX Helper and Windows UIA Helper in pi-computer-use](/injaneity/pi-computer-use/architecture-differences-mac-os-ax-helper-vs-windows-uia-helper)

Explore macOS AX Helper vs Windows UIA Helper architecture. Understand Unix-domain sockets, Accessibility API, child processes, and UI Automation for pi-computer-use.

- Tags: architecture
- Published: 2026-07-16

### [How to Configure pi-computer-use Using Environment Variables and Config Files](/injaneity/pi-computer-use/how-to-configure-pi-computer-use-using-environment-variables-and-config-files)

Master pi-computer-use configuration by learning to set environment variables and use config files. Discover how settings merge with environment variables taking priority.

- Tags: how-to-guide
- Published: 2026-07-16

### [How Headless Mode Restrictions in Pi-Computer-Use Prevent Window Activation and Cursor Movement](/injaneity/pi-computer-use/how-headless-mode-restrictions-prevent-window-activation-and-cursor-movement)

Discover how pi-computer-use headless mode restrictions block window activation and cursor movement. Understand the headless boundary and foreground focus changes.

- Tags: deep-dive
- Published: 2026-07-16

### [setText vs keypress in pi-computer-use: Action Types Explained](/injaneity/pi-computer-use/difference-between-settext-typetext-and-keypress-action-types)

Understand the difference between setText and keypress action types in pi-computer-use. Learn when to use direct assignment versus simulating keystrokes for your automation needs.

- Tags: deep-dive
- Published: 2026-07-16

### [How act_ui Transactions Manage Preconditions and Postconditions with expect in pi-computer-use](/injaneity/pi-computer-use/how-do-act-ui-transactions-manage-preconditions-and-postconditions-with-expect)

Learn how act_ui transactions manage preconditions and postconditions with expect in pi-computer-use. Ensure deterministic automation via bidirectional wait-for polling.

- Tags: deep-dive
- Published: 2026-07-16

### [How the State-Scoped Observation Model Handles Root Refs and Element Refs in pi-computer-use](/injaneity/pi-computer-use/how-does-state-scoped-observation-model-handle-root-refs-and-element-refs)

Understand how pi-computer-use state-scoped observation model manages root refs and element refs. Learn about stable identifiers and snapshot-specific tokens for efficient state management.

- Tags: deep-dive
- Published: 2026-07-16