Without Aperio
Three terminals, three places to get stuck.
claudewaiting for permissioncodexwaiting for a design decisionagystopped on an error
You, tabbing between them.
formerly CAM local-first
Coding agents stop and wait for you. Aperio watches every agent you run, whoever built it: one agent list, one approval queue, one notification history. Hand todos to agents, let an agent run child agents, and find every accepted result later — in your browser, your terminal or your phone. Agents and code stay on your own machine.
curl -fsSL https://aperioai.top/install.sh | bash
macOS Apple Silicon · Linux x86_64 · Windows x86_64, native or WSL2 · Android APK. On macOS, the installer automatically prepares Node.js and tmux. The Linux dashboard needs Node.js 18.18+. Free for local use, forever →
Real screenshots from a running Aperio dashboard. Project names, paths and session content are pixelated.
01What’s new
Recent releases go past monitoring: agents can run their own child agents, todos turn into agent work, accepted results land in a searchable archive, and the whole thing now runs natively on Windows.
Windows
ConPTY sessions without WSL, tmux or Bash. The watcher and dashboard start as per-user tasks at logon; the WSL2 installer is still available.
Child agents
Add a child agent under any agent, in its own worktree. The parent waits on all of its children with a single watch.
Todos
Jot it down, hand it to a new or running agent, and it checks itself off when that work passes your acceptance.
History
Accepted work, the recycle bin and closed sessions in one place. Resume any session; add semantic search with your own embeddings endpoint.
Code Space
Browse, edit, diff and commit project files in the dashboard — on a phone too — and send a selection to a new agent.
Setup
Install Codex or Claude Code from the start form, pick reasoning effort per launch, and type aperio or cam — they are the same command.
02The problem
Every vendor ships a way to watch its own agent. None of them will ever show you a competitor’s. If your day is Claude Code in one repo, Codex in another and Antigravity CLI for a quick script, you are the glue. Aperio is that layer.
Without Aperio
claudewaiting for permissioncodexwaiting for a design decisionagystopped on an errorYou, tabbing between them.
With Aperio
In your browser, your terminal, or your phone.
03How it works
A permission prompt, a design decision, an error.
Agent-native hooks plus terminal polling.
A structured, deduplicated notification lands where you are looking.
Tap an option, or type your own answer.
Your reply is sent back into the agent’s session.
On macOS, Linux and WSL, agents run inside tmux; on native Windows they run in ConPTY sessions. Aperio combines agent-native hooks with terminal polling to decide whether an agent is working, idle, waiting for input, or asking for approval — then builds a structured notification, deduplicates it, and routes it to whichever surface you are actually looking at.
04Product
Captured from a live Aperio dashboard (Chinese UI). Everything that identifies a project or a session is pixelated.
B / Approvals
Aperio reads the agent’s question out of the terminal and turns it into structured, tappable options. You approve from a phone without typing into a TTY.

T / Child agentsNEW
Add a child agent under any agent from its card or right-click menu. It starts in the parent’s project, in its own worktree, and the parent waits on every open child with one watch instead of polling each one.

TODO / TodosNEW
Jot a todo in one line. Hand one or several to a new agent or to one that is already running, with a quick instruction — fix it, verify it, or plan first. When that agent’s work passes your acceptance, the todo checks itself off.
H / HistoryNEW
The history archive keeps accepted work, the recycle bin and closed sessions in one place, filtered by project. Summaries render as Markdown with working file links, and archived or deleted sessions can be resumed.

C / Code SpaceNEW
Open any file or folder path from an agent’s terminal or messages in Code Space: a Monaco editor with the file tree, full-text search, workspace and branch diffs, branch switching, commit, pull and push.


3D / Agent Base
Agent Base turns your agents into a 3D office: every agent has a desk, and its state shows on the name tag above it. Follow the camera or switch to first person, and work the “waiting on you” queue from the side panel.

A / Sessions
Open an agent to watch its live terminal beside the agent list, with quick keys and a message box below and its messages on the right.

M / Mobile
The same agent list and approval queue on a phone: tap an option instead of typing into a terminal. The Android app connects to your own dashboard, keeps several machines and downloads updates from the official download center. For background notifications, let it skip battery optimization when it asks.
Get the Android APK

TUI / Terminal
cam tui opens a four-panel terminal dashboard: agent list, terminal preview, notification history and details.
$ claude
> …
> …
project
risk
snapshot
05Supported agents
A unified adapter layer normalizes the differences between agents. Adding a new CLI agent is a config entry, not a fork.
| Agent | Adapter | Detection |
|---|---|---|
| Claude Code | Dedicated | Hooks + session JSONL |
| Codex CLI | Dedicated | Hooks + polling |
| Qoder | Dedicated | Hooks |
| Grok Build CLI | Built-in preset | Polling + screen rules for its TUI |
| Antigravity CLI | Dedicated | Polling |
| Mistral Vibe | Generic | Polling |
| Your own CLI agent | Custom | Polling — configure it in Settings |
Adapters declare their own detection strategy — HookOnly, HookWithPolling or PollingOnly — so hook-capable agents get instant events while everything else still works through terminal polling.
06Features
Monitor and approve agent requests from the dashboard, the TUI or your phone.
Real-time status and live terminals, plus todos, child-agent workspaces, Code Space and the history archive.
Children start in their own worktrees; the parent waits on all of them with one watch.
Hand a todo to a new or running agent; it checks itself off when the work is accepted.
Accepted work, recycle bin and closed sessions, with keyword or semantic search.
File tree, editor, search, diffs, commit, pull and push — on a phone too.
Your agent team as a 3D office, with a queue of who is waiting on you.
Each task as a tree of work items, from dispatch to acceptance.
Multi-agent orchestration: team creation, task assignment, progress tracking.
Install Codex or Claude Code from the start form; skip a missing skill for one launch.
Browse skills by agent and group, and translate a skill page without touching the file.
Four panels: agent list, terminal preview, notifications, details.
Auto-rates bash commands low, medium or high to support approval decisions.
Reads notification content out of terminal snapshots instead of hardcoded regex. Optional.
Persistent dedup and burst protection; the bell keeps one current alert per agent.
Runs in the background: launchd on macOS, systemd on Linux, logon tasks on Windows.
Drive Aperio from any MCP client, or from chat in natural language.
Remote control over WebSocket/SSE, with Wake-on-LAN support.
07Local-first
Your machine
08Pricing
Everything Aperio does locally is free, now and later: no seat limits, no feature gates, no trial that expires. Paid plans will only cover what needs our servers or your whole team.
Available now
Freeforever
Coming soon
For individuals
Coming soon
For teams and companies
Our promise: what is free today stays free. We will never move a local feature behind a paywall.
09Install
No Rust build toolchain required. The local dashboard needs Node.js 18.18+; macOS automatically installs missing Node.js and tmux. aperio and cam are the same command. Once the dashboard is running, its start form can install Codex or Claude Code for you.
Choose your platform below.
Apple Silicon (arm64). Complete macOS setup and log in locally first, including for SSH installs. Node.js (18.18+) and tmux are prepared automatically through Homebrew. Homebrew is installed if needed and may ask for your Mac administrator password. Command PATH is saved automatically; open a new terminal to use cam. New complete installs enable password-protected LAN access and check the Dashboard; existing explicit access preferences are kept. The DMG connects to an existing service.
curl -fsSL https://aperioai.top/install.sh | bash
When installation finishes, the installer prints the local Dashboard address and how to get the Aperio console access password (not your macOS or AI account password); versions that include it can show both again with cam dashboard and cam dashboard --show-password. Another device uses this host's reachable LAN/Tailscale address and console password. Local checks do not verify remote connectivity.
The installer is unavailable for this release. Use the package below or the GitHub backup.
Then run cam bootstrap to configure your agents, cam tui to monitor them, and cam start "implement a TODO app" to start one.
Linux x86_64. The installer uses tmux and sets up the CLI and local dashboard.
curl -fsSL https://aperioai.top/install.sh | bash
The installer is unavailable for this release. Use the package below or the GitHub backup.
Then run cam bootstrap to configure your agents, cam tui to monitor them, and cam start "implement a TODO app" to start one.
Windows is not available in this release. You can use the Windows · WSL tab.
Native Windows x86_64; WSL is not required. When an EXE is listed below, download and double-click it, then click Install in the graphical wizard. Once the dashboard is ready, the wizard can open it and copy your login password. The EXE includes the complete package. The dashboard needs Windows Node.js 18.18+; the installer checks it. The PowerShell command is also available.
& { $ErrorActionPreference = 'Stop'; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -UseBasicParsing -TimeoutSec 60 'https://aperioai.top/installers/install-windows-native.ps1' -OutFile "$env:TEMP\install-windows-native.ps1"; powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install-windows-native.ps1" -ReleaseBaseUrl 'https://aperioai.top/releases'; if ($LASTEXITCODE -ne 0) { throw "Installation failed (exit $LASTEXITCODE). See the error above." } }
The installer is unavailable for this release. Use the package below or the GitHub backup.
Open a new PowerShell window, run cam bootstrap, then cam service install --target mac-bridge --force to start the dashboard.
If Windows reports a missing VCRUNTIME140.dll, install the Microsoft VC++ x64 runtime and rerun the installer: Microsoft VC++ x64 Runtime
Run in Windows PowerShell with Ubuntu 22.04+ on WSL2. Upgrade an existing older Ubuntu distro to 22.04+. If Ubuntu is missing, run wsl --install -d Ubuntu as administrator, finish first-user setup and rerun this command.
& { $ErrorActionPreference = 'Stop'; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -UseBasicParsing -TimeoutSec 60 'https://aperioai.top/installers/install-windows.ps1' -OutFile "$env:TEMP\install-windows.ps1"; powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install-windows.ps1" -ReleaseBaseUrl 'https://aperioai.top/releases'; if ($LASTEXITCODE -ne 0) { throw "Installation failed (exit $LASTEXITCODE). See the error above." } }
The installer is unavailable for this release. Use the package below or the GitHub backup.
Then open Ubuntu with wsl -d Ubuntu and run cam bootstrap followed by cam tui inside WSL.
Install the APK on your Android phone, then connect it to your own running Aperio dashboard bridge. This is a companion app, not a local agent runtime.
curl -fsSL https://aperioai.top/install.sh | CAM_INSTALL_SERVICES=0 bashThe current DMG and Windows packages are not notarized / Authenticode-signed. Your OS may show an unsigned-app warning.
Enable JavaScript to see the current version, package sizes and checksums. The installer commands above and these links also work without JavaScript.