tty-avatar
/tty-avatar
Pokazuje żywego awatara 3D w terminalu, renderuje klatkę z pliku GLB i zmienia nastrój lub podpis awatara ze skryptów albo haków Claude Code.
- Autor
- nirholas ↗
- Repozytorium
- three.ws ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Pokazuje żywego awatara 3D w terminalu, renderuje klatkę z pliku GLB i zmienia nastrój lub podpis awatara ze skryptów albo haków Claude Code.
Oryginalny opis (EN)
Show a live 3D avatar in the terminal, print one rendered frame of any GLB, and change the avatar's mood or caption from scripts or Claude Code hooks. Use when the user wants to preview a GLB or three.ws avatar in a terminal or give a coding agent a visible face.
Jak działa
- Sources
- Commands
- Recipes
- Library
Podgląd SKILL.md
---
name: tty-avatar
description: Show a live 3D avatar in the terminal, print one rendered frame of any GLB, and change the avatar's mood or caption from scripts or Claude Code hooks. Use when the user wants to preview a GLB or three.ws avatar in a terminal or give a coding agent a visible face.
---
# tty-avatar
`@three-ws/tty-avatar` renders a GLB with a software rasterizer (no GPU, no browser) to truecolor half-blocks, braille or plain ASCII. Needs Node 18 or newer.
npx @three-ws/tty-avatar <source> [options]
## Sources
A local `./model.glb`, a GLB URL, a three.ws avatar id, `agent:<agent id>` (its 3D body), or a `https://three.ws/avatars/<id>` page URL. Id lookups use `--origin` or `THREE_WS_ORIGIN` (default `https://three.ws`).
## Commands
tty-avatar <source> run the live viewer
tty-avatar snapshot <source> [opts] print one frame and exit
tty-avatar mood <name> [--say text] [--ttl ms] change the running viewer's mood
tty-avatar say <text> change the caption
tty-avatar hook read a hook payload on stdin, hand it to the viewer
tty-avatar install-hooks [--write] [--json] Claude Code hooks to this viewer
tty-avatar moods list moods
Moods: idle, spin, think, work, talk, happy, attention, error, sleep.
Useful flags: `--mode blocks|braille|ascii` (ascii is the default when stdout is not a TTY), `--mood`, `--fps`, `--columns`, `--rows`, `--yaw`, `--pitch`, `--zoom`, `--frames <n>` (exit after n frames), `--no-caption`, `--no-alt`, `--max-triangles`, `--state-dir` (or `TTY_AVATAR_DIR`), `--no-state`, `--plain` (snapshot without colour).
## Recipes
Check a model without opening a viewer (works in a non-interactive shell):
npx @three-ws/tty-avatar snapshot ./hero.glb --mode ascii --columns 80 --rows 40 --yaw 30
Give a coding agent a face:
1. Run `npx @three-ws/tty-avatar install-hooks` to print the settings fragment, or add `--write` to merge it into `~/.claude/settings.json`. Only write to the user's settings file when the user asked for it.
2. The user runs a viewer in a split pane: `npx @three-ws/tty-avatar <avatar id>`.
3. The viewer polls `~/.three-ws/tty-avatar/event.json` and maps Claude Code events to moods (UserPromptSubmit think, PreToolUse work, Stop happy, SessionEnd sleep).
Signal progress from a script:
tty-avatar mood happy --say "deploy landed" --ttl 5000
## Library
import { resolveSource, parseGlb, TtyAvatar, snapshot } from '@three-ws/tty-avatar';
const { bytes } = await resolveSource('./hero.glb');
const mesh = await parseGlb(bytes);
console.log(snapshot(mesh, { mode: 'ascii', columns: 60, rows: 30 }));
Wersje
W bazie nie ma innych skilli o nazwie tty-avatar.
Migawka bazy z 13.11.2026 · wersja paczki 499242f2f201 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100avatar-and-glb-tools
Tworzy i ubiera awatara 3D, nadaje mu mowę, renderuje kadry i sprawdza, optymalizuje lub miniaturuje pliki GLB. - 100render-an-avatar
Renderuje avatar glTF lub GLB do PNG, animowanego PNG lub podglądu w terminalu, bez karty graficznej i przeglądarki. - 100awesome-agent-avatars
Dodaje animowanego, interaktywnego awatara agenta AI do aplikacji webowej lub desktopowej, reagującego na aktywność agenta. - 100build-avatar-app
Tworzy aplikację wokół awatara Atmee: sesje, dołączanie do rozmowy, stan aplikacji, zdarzenia, narzędzia i pliki. - 90Face
Przygotowuje krótkie listy awatarów dla agenta lub profilu, z wyborem płci, przejrzystymi opcjami i linkami do profili. - 100avatar-maker
Zamienia zdjęcie użytkownika w warianty zdjęcia profilowego, headshotu lub awatara w spójnym stylu, z zachowaniem tożsamości, domyślnie przez nano-banana-pro i w wielu proporcjach.