cinetty skill
cinetty plays architecture animations in the terminal: pick a template, describe the system in one YAML file and watch.
- 84 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Installation pulls Python dependencies and the photo template also downloads vision models.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/cinettyDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Installation pulls Python dependencies and the photo template also downloads vision models.
This is third-party code. Review the repository files before installing.
What it does
cinetty draws animated architecture diagrams in terminal cells. The author picks a template such as `loop-landscape`, `circuit-flow`, `screen-flow` or `photo-loop`, describes the system in one `project.yaml` file and checks constraints. Playback starts with `make play INPUT=examples/circuit-flow/project.en.yaml` and `make templates` shows the catalog. `SKILL.md` sits in the repository root, so the whole clone works as a skill for Claude Code and Codex: the agent prepares the YAML and runs the player. The photo template needs a terminal with Kitty graphics and vision models.
Who it is for. Developers and technical authors who need a clear architecture animation for a terminal demo or a video recording.
Good fit when
- An agent architecture must be shown in the terminal as an animation instead of a slide.
- The agent should prepare a YAML description of the system and check it itself.
- A talk needs a short clip from a terminal window.
- A diagram with several feedback loops must be shown step by step.
Not a fit when
- You need an interactive diagram editor or SVG export.
- You work on Windows: macOS and Linux are stated.
- The terminal cannot fit the required cell grid.
Example request
Describe my agent self improvement loop in YAML on the `loop-landscape` template and play the animation in the terminal.Limitations
macOS and Linux with Bash and Make are stated, and Python 3.12 or newer or `uv` is required. Text templates install with `make setup` at about 73 MB. The `photo-loop` template needs `make setup-photo` with PyTorch and two models at about 2 GB and a terminal with the Kitty graphics protocol, such as Ghostty, Kitty or WezTerm. For Chinese text the Sarasa Term SC font is recommended. If the terminal is smaller than the required grid, the player warns and the window must be enlarged.
How to disable. Delete the `~/.claude/skills/cinetty` or `~/.agents/skills/cinetty` folder, which also removes the `.venv` virtual environment.
FAQ
Where do I install it for Codex?
Into `~/.agents/skills/cinetty` for all projects or `.agents/skills/cinetty` inside a single project.
How do I loop playback?
Add `LOOP=1`: `make play INPUT=... LOOP=1`. Stop with `Ctrl-C`.
How do I record a video?
Record the terminal window with any screen recorder, as the project has no export of its own.
Which templates exist?
`loop-landscape`, `loop-portrait`, `circuit-flow`, `screen-flow` and `photo-loop`. `make templates` prints the full list.
Are there documentation translations?
Yes, there are READMEs in Chinese and Japanese.
Discussion
No questions or reviews yet.
Related
SkillsA skill that turns one JSON file into a live architecture diagram styled as a terminal panel, rendered to MP4 or a web page
A Claude Code skill for code-made video: it splits a clip into scenes and picks an engine for each, from Paper.js to Manim.
Claude Code skill for pixel art: sprites, animations and effects built from a reference and checked frame by frame
ascii-art builds a dot-grid figure from a photo and animates it into a seamless loop: dust, growth, voids
Six Claude Code skills make animation for reels with no footage: graphs, map routes, exploded views and narrated explainers
Skills give Claude Code three ways to make images: code-drawn graphics, Three.js 3D scenes and Flux diffusion on Cloudflare.
README in short
A player for animated architecture diagrams in the terminal. Templates, a YAML description, constraint checks and a skill mode for Claude Code and Codex.