Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

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.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Sources
  2. Commands
  3. Recipes
  4. Library
Sekcje z nagłówków SKILL.md, w oryginale · 48 linii, 312 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.