Skip to content

dwgx/SmartCLI / skills/cmd-art

cmd-art

Verified

Design 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.

fx/util.py

View on GitHub
"""Shared frame-assembly helpers: colored grids, ANSI-aware padding, ramps.

Effects build a (char, color) grid; :func:`grid_to_str` turns it into a frame
string emitting a truecolor escape ONLY when the color changes between adjacent
cells (the single biggest output-size optimization for full-screen effects).
"""
from __future__ import annotations

import re

from .core import RESET, rgb

RGB = tuple[int, int, int]

_ANSI_RE = re.compile(r"\x1b\[[0-9;:]*[A-Za-z]")


def new_grid(width: int, height: int):
    """height x width grid of ``None`` cells. Cell = None | (char, RGB | None)."""
    return [[None] * width for _ in range(height)]


def grid_to_str(grid, bg: bool = False) -> str:
    """Join a cell grid into a frame string with minimal color escapes.

    Cells: ``None`` -> plain space; ``(ch, None)`` -> uncolored char;
    ``(ch, (r,g,b))`` -> truecolor char. Every row ends with RESET so partial
    rows never bleed color into the next line. ``bg=True`` colors backgrounds.
    """
    lines = []
    for row in grid:
        parts = []
        last = None
        for cell in row:
            if cell is None:
                if last is not None:
                    parts.append(RESET)
                    last = None
                parts.append(" ")
                continue
            ch, color = cell
            if color != last:
                parts.append(RESET if color is None else rgb(*color, bg=bg))
                last = color
            parts.append(ch)
        parts.append(RESET)
        lines.append("".join(parts))
    return "\n".join(lines)


def visible_len(line: str) -> int:
    """Length of *line* in terminal cells, ignoring ANSI escapes.

    Assumes single-width glyphs (true for the ASCII/box/block chars we emit).
    """
    return len(_ANSI_RE.sub("", line))


def pad_visible(line: str, width: int) -> str:
    """Right-pad *line* with spaces to *width* visible cells (no truncation)."""
    gap = width - visible_len(line)
    return line + (" " * gap if gap > 0 else "")


def frame_lines(frame: str, height: int, width: int) -> list[str]:
    """Split a frame into exactly *height* lines, each padded to *width* cells."""
    lines = frame.split("\n")[:height]
    while len(lines) < height:
        lines.append("")
    return [pad_visible(ln, width) for ln in lines]


def clamp(v, lo, hi):
    return lo if v < lo else hi if v > hi else v
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall