Your AI agents,
living on your desktop.

What you are looking at

The demo above replays a scripted day. On your desktop, the same garden reacts to your real sessions in real time.

• Sub-agents pop out of a portal their parent opens (“Calling backup!”), orbit it as mini-bots and report back when done.
• Codex is white & cyan, one antenna. Claude is dark & amber, two antennas.
• Prompts land in their hands. The envelope waits at the terminal, slides down the conduit, and the robot starts its quest with the capsule in hand.
• Delivered answers are held up as a letter (“All yours!”) until you come back — then the robot walks home.
• A mechanical dog patrols, flags waits and errors, chases butterflies and fetches the ball. Hold a click on it for a heart.
• A basketball hoop that moves after every basket. Throw the ball yourself, or watch idle robots line up a shot — streaks and best score are kept.
• Butterflies by day, fireflies by night (21:00–07:00, your PC clock).
• Audio spectrum of your PC sound, 48 bands from 40 Hz to 20 kHz, with the current track title. When the bass stays up, resting robots dance and the flowers shake.
• Click the garden to call idle robots over. Click a robot to make it wave.
• Any screen shape: the garden lays itself out for landscape, portrait, square and ultrawide.

Install on Wallpaper Engine

1. 1
   Download agent-transit-wallpaper.zip and unzip it.
2. 2
   Copy the folder to …\steamapps\common\wallpaper_engine\projects\myprojects\agent-transit
3. 3
   In Wallpaper Engine, open Installed → filter “My projects”, pick Agentic Wallpaper, choose your monitor. Done — decor, dog, ball, hoop, butterflies and native audio work right away.

Full walkthrough with screenshots and settings: docs/INSTALL-WALLPAPER-ENGINE.md · version française

Connect your real agents

The living part needs a tiny local relay (Node ≥ 20) that receives the hook events of Claude Code and Codex — both supported, both at once — and streams them to the wallpaper.

Install Agentic Wallpaper from https://github.com/DrMoussavie/agentic-wallpaper on this Windows PC so it works with BOTH Claude Code and Codex.

1. Check Node.js >= 20 is available (install it with winget if not).
2. Clone the repo into a permanent folder, e.g. %USERPROFILE%\agent-transit, then run: npm install
3. Run: npm run hooks:install  (it merges the hooks into ~/.claude/settings.json and the Codex config, keeps backups, changes nothing else).
4. Run: powershell -NoProfile -ExecutionPolicy Bypass -File scripts/configure-startup.ps1  so the relay starts with Windows, then start it now in the background with: npm start
5. Verify http://127.0.0.1:49157/health answers.
6. Run: npm run export  and copy dist/wallpaper to <Steam>\steamapps\common\wallpaper_engine\projects\myprojects\agent-transit (find my Steam library path first).
7. Select "Agentic Wallpaper" in Wallpaper Engine → Installed is a click I do myself; just tell me.
8. IMPORTANT — end your answer with an explicit reminder, in bold: if I use Codex, I must approve the hooks myself in the Codex app (Settings → Hooks → From configuration → Approve on each Agentic Wallpaper entry), otherwise they are silently ignored and no robot will appear. If I use Claude Code, nothing to approve: the hooks are picked up automatically.

Do not touch anything else in my Claude Code or Codex settings.

git clone https://github.com/DrMoussavie/agentic-wallpaper
cd agentic-wallpaper
npm install
npm run hooks:install     # adds the hooks to Claude Code AND Codex
npm start                 # relay on http://127.0.0.1:49157