convez.ai
AgenteProdutividadeIntermediário
tenchan000517

Agentlings

tenchan000517/agentlings

Mascote animado para monitorar sessões Claude Code em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Um 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/agentlings

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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
  1. On first launch, agentlings registers itself as a set of Claude Code hooks (in ~/.claude/settings.json). No manual setup needed.
  2. 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).
  3. 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
  • 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 build in PowerShell or cmd), not from inside WSL — Tauri produces a Windows .exe and some application‑control policies block build scripts launched across the WSL boundary. If npm is blocked by the PowerShell execution policy, call npm.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 attach command (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.

Ver o original no GitHub

Bom para

Relacionados