convez.ai
AgenteUtilidadesIntermediário
Atomics-hub

Agent Screensaver

Atomics-hub/agent-screensaver

Torna esperas de agents divertidas com Nyan Cat e GIFs customizados no terminal

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent que transforma a espera de execução de Claude Code e Codex em entretenimento visual direto no terminal. Oferece animações ANSI customizáveis (Nyan Cat clássico ou GIFs próprios) em modo compacto (uma linha) ou completo, sem dependências externas e totalmente local.

Instalação

$npx convez-ai Atomics-hub/agent-screensaver

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

  • Melhorar experiência visual enquanto agents executam tarefas
  • Adicionar feedback visual personalizado em workflows com Claude Code e Codex
  • Demonstrações técnicas com animações terminal customizadas

Veredito

Projeto criativo e bem executado que resolve um problema real (feedback visual durante execução) com solução leve e zero dependências. Instalação local reversível, customizável e sem tracking. Útil principalmente para devs que usam Claude Code/Codex regularmente e querem melhorar a experiência do terminal.

README

A tradução para o português deste README ainda está na fila.

Agent Screensaver

Make Claude/Codex waiting stupidly fun.

Agent Screensaver is an installer-first local toy for coding agents. The product surface is Claude Code and Codex: lifecycle hooks, terminal statusline text, spinner verbs, compact/full terminal animations while non-interactive agent commands are running, and a quiet local sidecar that stores the current GIF. The browser page is only the debug/settings room for custom GIFs, mode settings, and video capture.

Demos

Daily-driver compact mode stays on one terminal line:

Codex compact mode

Claude compact mode

Full proof mode is the big terminal Nyan:

Codex full mode

Claude full mode

MP4 versions: Codex compact, Codex full, Claude compact, Claude full.

The demo clips use a local sleeping child process, so the repo can show the wrapper behavior without spending model calls.

What ships in v0

  • Claude Code lifecycle hook bridge
  • Codex lifecycle hook bridge
  • Claude Code terminal statusline injection
  • Claude Code spinnerVerbs injection
  • Compact one-line ticker mode for daily use
  • Full hand-animated ANSI Nyan Cat proof mode for demos
  • Codex CLI wrapper for codex exec
  • Claude Code CLI wrapper for claude -p/--print
  • Quiet Codex CLI wrapper that arms Agent Screensaver
  • Default Classic Nyan GIF
  • Custom GIFs from browser upload, local file, or URL
  • Optional local debug/settings page
  • VS Code companion status bar/debug panel
  • Zero npm dependencies

Install It

git clone https://github.com/Atomics-hub/agent-screensaver.git
cd agent-screensaver
npm link
agent-screensaver install all

That installs:

  • ~/.claude/settings.json statusline, spinner verbs, and lifecycle hooks
  • a reversible ~/.local/bin/claude wrapper
  • ~/.codex/hooks.json lifecycle hooks
  • a reversible Codex CLI wrapper

Hooks auto-start the local sidecar on 127.0.0.1:4555. You do not need to open a browser for the product to work.

Codex requires one local trust pass before new hooks run. Open Codex once after install and choose Trust all and continue, or use /hooks inside Codex to review/trust Agent Screensaver.

Restore everything:

agent-screensaver restore all

Change The GIF

Current GIF:

agent-screensaver gif current

List saved GIFs:

agent-screensaver gif list

Use a URL:

agent-screensaver gif set "https://media.giphy.com/media/sIIhZliB2McAo/giphy.gif"

Use or upload a local file:

agent-screensaver gif set ~/Downloads/my-agent.gif
agent-screensaver gif upload ~/Downloads/my-agent.gif

Reset to Classic Nyan:

agent-screensaver gif reset

Custom files are copied to:

~/.agent-screensaver/gifs

No cloud. No account. No analytics.

Change The Terminal Mode

Compact mode is the default and stays on one terminal line:

agent-screensaver mode current
agent-screensaver mode set compact

Full mode is for demos and proof videos:

agent-screensaver mode set full

You can also override per command:

AGENT_SCREENSAVER_MODE=full codex exec "..."
AGENT_SCREENSAVER_MODE=compact claude -p "..."

Classic Nyan gets a tuned terminal pixel loop in full mode and a one-line ticker in compact mode. Uploaded GIFs play exactly in the debug/settings page, use iTerm2 inline image playback when that terminal is available, and otherwise use an animated terminal poster fallback so arbitrary GIFs do not get jammed through the Nyan sprite.

Claude Code Notes

Interactive Claude Code owns its terminal UI, so Agent Screensaver does not take over the whole screen there. In interactive Claude, the integration is the statusline, spinner verbs, and lifecycle hooks. The wrapper animation runs for non-interactive claude -p / claude --print commands.

Debug Page

The page exists for settings, visual checks, and X/Twitter capture. It is not the primary product surface.

agent-screensaver start --open

Default URL:

http://127.0.0.1:4555

Manual test events:

agent-screensaver event thinking --message "Agent launched"
agent-screensaver event working --message "Tool call running"
agent-screensaver event success --message "Done"

Terminal Nyan preview:

agent-screensaver nyan --message "Codex is thinking" --frames 1

VS Code Companion

This is a companion layer: a status bar item and debug panel that mirror the local sidecar. It does not yet patch private Claude/Codex extension webviews directly.

npm run package:vsix
code --install-extension agent-screensaver-0.1.0.vsix

Command palette:

Agent Screensaver: Open Debug Panel
Agent Screensaver: Start Local Sidecar
Agent Screensaver: Test Working
Agent Screensaver: Test Success

Record Proof

Real Codex CLI proof with full terminal Nyan plus hook receipt:

npm run record-cli-proof

Debug page proof driven by real Codex hooks:

npm run record-demo

VS Code companion proof:

npm run record-vscode-proof

Wrapper demo matrix used in this README:

npm run record-wrapper-matrix

Outputs:

out/agent-screensaver-cli-proof.mp4
out/agent-screensaver-demo.mp4
out/agent-screensaver-vscode-proof.mp4
docs/media/codex-compact.mp4
docs/media/codex-full.mp4
docs/media/claude-compact.mp4
docs/media/claude-full.mp4

macOS may ask for Screen Recording permission the first time.

Hook Notes

Claude Code hooks receive JSON on stdin. Agent Screensaver installs one command hook:

agent-screensaver hook claude

Codex hooks receive JSON on stdin. Agent Screensaver installs one command hook:

agent-screensaver hook codex

Both adapters log proof events locally:

~/.agent-screensaver/hook-runs.jsonl

Research Notes

Patterns checked before building:

  • Claude Code hooks and status lines
  • Codex hooks
  • Agent Arcade-style transparent overlays
  • Claude statusline tools
  • Tamagotchi-style Claude Code toys
  • Kickbacks-style install surface: terminal/statusline/webview integration first, website second

Useful docs:

Tags

#ClaudeCode #Codex #AIAgents #Terminal #OpenSource

Ver o original no GitHub

Bom para

Relacionados