@ohgodtamit/pi-agent-browser

A lean native agent-browser integration for Pi. This package is a partial fork of pi-agent-browser-native and retains the public tools agent_browser and agent_browser_web_search, plus the pi-agent-browser-doctor and pi-agent-browser-config bins.

Benefits

• PATH-safe process discovery. Managed-session lock ownership resolves POSIX ps without assuming /bin/ps or /usr/bin/ps, including Nix-style systems.
• No brittle runtime exact-version gate. Different valid agent-browser versions can run; doctor reports baseline drift as an advisory recommendation. Missing binaries and malformed executions still fail clearly.
• Lean prompt overhead. Only essential workflow invariants are injected on every turn; the detailed command and result contract stays in installed docs.
• UI-independent tools. agent_browser and agent_browser_web_search never prompt; both return model-facing content plus structured details, so TUI, RPC, and headless runs see the same data. Browser-call details include artifacts, verification, and next actions when relevant. renderCall/renderResult only enhance the TUI presentation.
• Conditional web search. agent_browser_web_search registers only when enabled configuration has a potential Exa or Brave credential source; the credential resolves at execution.

Installation

Requirements: Node >=22.22.2, Pi >=0.84.0 <0.86.0, and the agent-browser CLI. The package does not bundle the upstream agent-browser binary.

pi install npm:@ohgodtamit/pi-agent-browser
npm install -g agent-browser
pi-agent-browser-doctor

pi-agent-browser-doctor checks the installation and reports baseline drift as an advisory.

Essential workflow

Use one input mode per call. The common flow is open → snapshot -i → interact with current @refs → re-snapshot after page changes. Use sessionMode: "fresh" for new launch-scoped flags. Preserve exact requested artifact paths, verify details.artifactVerification, and follow exact details.nextActions payloads when present.

Configuration is stored under .pi/config/pi-agent-browser/config.json or ~/.pi/config/pi-agent-browser/config.json. Run pi-agent-browser-config --help for setup commands.

Reference

• Command reference
• Tool contract
• Architecture
• Electron workflows
• Requirements and support, support matrix

Development

npm run typecheck --workspace @ohgodtamit/pi-agent-browser
npm run unit --workspace @ohgodtamit/pi-agent-browser
npm run pack:inspect --workspace @ohgodtamit/pi-agent-browser
npm run smoke:installed --workspace @ohgodtamit/pi-agent-browser

Provenance

This package is a partial fork of pi-agent-browser-native. See THIRD_PARTY_NOTICES.md for pinned donor provenance and retained MIT attribution.

License

MIT © 2026 Christopher Tam. Third-party adaptations remain subject to their retained MIT notices.