Peekaboo is a macOS command-line tool and menu-bar app that captures screens, inspects accessibility information, and controls native user interfaces. AI agents and MCP clients use it to observe applications and carry out interactions on a Mac.
Borrowing it
Nothing to install: this file belongs to openclaw/Peekaboo. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/openclaw/Peekaboo/main/AGENTS.mdgit clone --depth 1 https://github.com/openclaw/PeekabooWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/openclaw/peekaboo/agents-md)<a href="https://agentmods.dev/instructions/openclaw/peekaboo/agents-md"><img src="https://agentmods.dev/badge/instructions/openclaw/peekaboo/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/openclaw/peekaboo/agents-md"><img src="https://agentmods.dev/badge/instructions/openclaw/peekaboo/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01164 | $0.01164 |
| Opus 5.5 | $0.00466 | $0.00466 |
| Sonnet 5.5 | $0.00233 | $0.00233 |
| Haiku 4.5 | $0.00116 | $0.00116 |
Grade A, and why
Peekaboo AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 47 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Repository Guidelines
Start Here
- Read
~/Projects/agent-scripts/{AGENTS.MD,TOOLS.MD}before making changes (skip if missing). - This repo uses git submodules (
AXorcist/,Commander/,Swiftdansi/,Tachikoma/,TauTUI/); update them in their home repos first, then bump pointers here.
Project Structure & Modules
Apps/CLIcontains the SwiftPM package for the command-line tool; commands live underApps/CLI/Sources, and unit/integration tests underApps/CLI/Tests.Apps/Mac,Apps/PeekabooInspector, andApps/Playgroundhost the macOS apps and related tooling; openApps/Peekaboo.xcworkspacefor Xcode work.- Shared logic sits in
Core/PeekabooCore(automation, agent runtime, visualizer). Keep new utilities there rather than duplicating in apps. - Git submodules provide foundational pieces:
AXorcist/(AX automation),Commander/(CLI parsing),Swiftdansi/(ANSI parsing),Tachikoma/(AI providers/MCP), andTauTUI/. Update them upstream first, then bump the pointers here. - Documentation lives in
docs/; assets and marketing material are inassets/.
Build, Test, and Development Commands
- Current CI baseline is macOS 27 on arm64 with Xcode 27.0 and its bundled Swift toolchain. Keep the macOS 15 deployment targets and the pre-macOS-27 Swift runtime audit intact when changing build settings.
- Run tools directly (runner removed). Use pnpm (Corepack-enabled).
- Build the CLI:
pnpm run build:cli(debug) orpnpm run build:swift:all(universal release). For arm64-only:pnpm run build:swift. - Rebuild the Mac app while editing Swift:
./scripts/build-mac-debug.sh. - Validate before handoff:
pnpm run lint(SwiftLint),pnpm run format(SwiftFormat fix;pnpm run format:check= CI gate), thenpnpm run test:safe. Full automation/UI tests:pnpm run test:automationorpnpm run test:all. - Tachikoma live provider checks:
pnpm run tachikoma:test:integration. - You may run
peekabooCLI commands locally for repros/debugging; be mindful they capture the host desktop (screen recording/accessibility permissions required).
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago Changed · +2 tokens per session 741fe67b8bcf
- 14d ago Changed · +75 tokens per session 47569af7b4ca
- 16d ago Changed · +7 tokens per session 44833680a77c
- 21d ago Changed · +10 tokens per session 8dc48f8fc314
- 2mo ago First seen · 47 lines · 1,070 tokens per session scan A bc672c6ad5a4
Peekaboo AGENTS.md is an instructions file published in the GitHub repository openclaw/Peekaboo (5,403 stars, last pushed yesterday), licensed MIT. It adds 1,164 tokens to every session, about $0.0047 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.