dwgx/SmartCLI / skills/cmd-art
cmd-art
VerifiedDesign and render terminal/CMD visual effects and ASCII art from a one-line request via the pluggable `fx` engine (30 effects, hot-swappable and themeable, plus scripted shows). Effects include donut, matrix rain, plasma, fire, a spinning 3D ball, a solar-system orrery, Game of Life, wireframe cube, 3D text banners, rainbow/lolcat gradient text, starfield, tunnel, fireworks, image-to-ASCII, and more. Use when the request is for a terminal animation, ANSI/CLI art, or a new console effect. Pure Python stdlib; truecolor.
tmux/README.md
View on GitHub# fx + tmux
Optional tmux launchers for the `fx` effect engine. These are a convenience
layer: they let you throw an effect into a **popup** or a **split pane** without
leaving your current tmux window. They are *not* required -- the fx play loop
already owns its own single alt-screen session, so `python -m fx play <effect>`
works standalone in any VT terminal.
> If `tmux` is not on `PATH`, both scripts detect that, print how to install it
> (and the no-tmux alternative), and exit `0` cleanly -- they never fail a
> pipeline just because tmux is missing.
## Scripts
### `fx-popup.sh` -- effect in a floating popup
Opens `tmux display-popup -E` (needs **tmux >= 3.2**) running one effect, then
closes the popup when it ends.
```sh
fx-popup.sh donut --theme fire # play donut in an 80%x80% popup
fx-popup.sh gallery --seconds-per 2 # tour every effect in a popup
fx-popup.sh random # surprise me
fx-popup.sh -w 100 -h 30 sphere # size the popup (cols x rows or NN%)
```
The first non-flag token is the effect name (bare subcommands `gallery`,
`random`, `show`, `list`, `play` are passed through as-is); everything after it
goes straight to `python -m fx`. `play`/`random`/effect runs get a default
`--seconds 10` bound unless you pass `--seconds`/`--frames`/`--forever`/`--once`,
so a popup never runs forever by accident.
### `fx-split.sh` -- effect(s) in split panes
Must be run **inside** a tmux session (`$TMUX` set).
```sh
fx-split.sh donut --theme fire # split, run donut in the NEW pane
fx-split.sh donut fire # 2-up: donut | fire, side by side
fx-split.sh -v donut # vertical (stacked) split instead
fx-split.sh donut fire --theme synthwave # trailing fx flags apply to BOTH
```
- One effect -> a new pane runs it, current pane untouched.
- Two effects -> current pane is respawned with the first effect, a new pane
runs the second (a clean 2-up). Same default-bound rule as the popup.
For per-effect themes/params, a single seamless alt-screen, and no pane
borders, prefer the **built-in compositor** instead of tmux panes:
```sh
python -m fx show --seq "donut|fire:synthwave:6" # split INSIDE one screen
python -m fx show --seq "donut:fire:6,plasma::4" # timed multi-segment show
```
## Truecolor passthrough (important)
tmux collapses 24-bit color to 256 unless you tell it the outer terminal is
truecolor-capable. Add to `~/.tmux.conf`:
```tmux
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*:Tc"
```
- `default-terminal "tmux-256color"` advertises a modern terminfo to programs
inside tmux.
- `terminal-overrides ",*:Tc"` sets the `Tc` (truecolor) capability for every
outer `$TERM`, so tmux forwards `\x1b[38;2;R;G;Bm` / `\x1b[48;2;R;G;Bm`
sequences verbatim instead of quantizing them.
Reload after editing: `tmux source-file ~/.tmux.conf` (or start a fresh
server). Verify with `tmux info | grep Tc` (should show `Tc: (flag) true`), and
your outer terminal (Windows Terminal, iTerm2, kitty, etc.) must itself support
truecolor. Newer tmux also honors `set -as terminal-features ",*:RGB"` as an
alternative to the `Tc` override.
## Configuration
- `FX_PYTHON` -- interpreter to use (default: first of `python3`, `python`, or
the Windows `py -3` launcher found on `PATH`).
- Popup size: `-w/--popup-width`, `-h/--popup-height` accept tmux size syntax
(`80%`, `100`, etc.). Split direction: `-h` (side by side, default) or `-v`
(stacked).
Both scripts resolve their own location (following symlinks) to find the skill
dir, so they work from any cwd and regardless of where they're symlinked.
## No-tmux degradation
When `tmux` is not on `PATH`, each script prints:
1. the direct standalone command (`python -m fx play <effect>`),
2. for `fx-split`, the compositor `--seq "a|b"` equivalent,
3. install hints (apt / brew / WSL),
then exits `0`. `fx-split.sh` also exits non-zero only for real usage errors
(no effect name, `exit 2`; not inside tmux while tmux *is* installed, `exit 4`).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |