Agentlings
tenchan000517/agentlings
Mascote animado para monitorar sessões Claude Code em tempo real
Ver no GitHubUm mascote de desktop que transforma suas sessões de Claude Code em personagens animados em tempo real. Construído com Tauri, roda como um aplicativo leve (~8 MB) multiplataforma que monitora hooks de IA e exibe visualmente o que cada agente está fazendo.
Instalação
npx convez-ai tenchan000517/agentlings1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Visualizar múltiplas sessões de Claude Code rodando simultaneamente
- Monitorar ações de IA (leitura, escrita, execução de comandos) com feedback visual
- Navegar rapidamente entre projetos e sessões de agentes
Veredito

Ferramenta criativa que adiciona dimensão visual ao monitoramento de agentes Claude Code. Prática para workflows com múltiplas sessões simultâneas, embora seja mais uma utilidade de visualização que um multiplicador de capacidades.
README
A tradução para o português deste README ainda está na fila.
agentlings
A lightweight desktop pet that turns your running Claude Code sessions into little animated characters, in real time.
Built with Tauri 2 — the final binary is ~8 MB. Cross‑platform (Windows / macOS / Linux).
agentlings is a friendly fork of claude-pet by IMMINJU (MIT). See CREDITS.
What it does
agentlings sits on your desktop and shows what each Claude Code session is doing — reading files, writing code, running commands, searching, waiting for input, and more. Each action triggers a different emoji/character and animation.
When you run multiple sessions, each one gets its own little character side by side, labelled with the project folder it is running in. So you can tell at a glance which session needs you.
How it works
Claude Code hooks → agentlings --hook → TCP socket → Tauri (Rust) → WebView UI
- On first launch, agentlings registers itself as a set of Claude Code hooks
(in
~/.claude/settings.json). No manual setup needed. - When Claude Code fires a hook (PreToolUse, PostToolUse, Stop, SessionStart, …)
it runs
agentlings --hook, a tiny sender that forwards the event over a local TCP socket (127.0.0.1:19876). - The Rust backend receives it and the WebView updates the character, animation, and speech bubble.
Requirements
To build from source you need:
- Node.js 18+ and npm
- Rust (stable) — install via https://rustup.rs
- Tauri 2 system dependencies for your OS — follow
https://tauri.app/start/prerequisites/
- Linux:
webkit2gtk,libgtk-3,libayatana-appindicator3, etc. - macOS: Xcode Command Line Tools
- Windows: WebView2 (preinstalled on Win 11) + MSVC build tools
- Linux:
- tmux (optional) — only needed for the click‑to‑attach and auto‑cleanup features
Build & run
git clone https://github.com/tenchan000517/agentlings.git
cd agentlings
npm install # installs the Tauri CLI
npm run build # builds the release binary
The binary is written to:
- Linux:
src-tauri/target/release/agentlings - macOS:
src-tauri/target/release/agentlings - Windows:
src-tauri/target/release/agentlings.exe
Run it:
# Linux / macOS
./src-tauri/target/release/agentlings
# Windows (PowerShell)
& .\src-tauri\target\release\agentlings.exe
For development with hot reload:
npm run dev # tauri dev
Windows + WSL note: build on the Windows side (e.g.
npm run buildin PowerShell orcmd), not from inside WSL — Tauri produces a Windows.exeand some application‑control policies block build scripts launched across the WSL boundary. Ifnpmis blocked by the PowerShell execution policy, callnpm.cmd.
After the first run, open a Claude Code session in any folder and a character appears. (Hooks were registered on first launch, so you may need to start a new Claude Code session for them to take effect.)
Usage
- Drag the window anywhere; it stays always‑on‑top.
- Left‑click a character → opens VS Code at that session's folder and shows its
tmux attachcommand (copied to the clipboard). - Right‑click a character → Remove from list, plus theme / language / focus mode / quit.
- Right‑click empty space → Bring all VS Code windows to front (Windows), plus the same settings menu.
Closed sessions are removed automatically (via a lazy tmux liveness check), so the roster reflects what is actually running.
Themes
agentlings ships with three built‑in themes: default (emoji), cat, and fruits.
Switch via right‑click → Theme.
Custom themes
Drop a theme folder into ~/.agentlings/themes/<name>/ with a config.json that maps
states to images or emoji. User themes override built‑ins. Example config.json:
{
"name": "My Theme",
"type": "image",
"states": {
"idle": { "src": "idle.png" },
"bash": { "src": "run.png" },
"error": { "src": "oops.png" }
}
}
Place the referenced images next to config.json. See the bundled src/themes/cat/
for a complete example.
Session labels
By default the label under each character is the folder name of the session's current working directory. This is intentionally generic — no project layout is assumed.
Uninstall
Delete the binary and remove the agentlings hook entries from
~/.claude/settings.json (look for commands ending in --hook). Optionally remove
~/.agentlings/.
Credits & License
agentlings is built on claude-pet by IMMINJU. Both the original work and these modifications are released under the MIT License. See LICENSE and CREDITS.