CLI ASCII Logo

Goals

• Generate ASCII art Logo (with borders and gradient colors) that can be directly output in the terminal
• Output "copy-paste ready" results (plain text/with ANSI colors), and provide integration methods for displaying when the CLI starts
• Provide a runnable generation script:

  scripts/generate_logo.py

Workflow

1. Clarify input
   • Name: e.g.,

     auto-cli

   • Subtitle: e.g.,

     Command Line Interface

   • Terminal width: default 80 (adjustable according to project/CI output)
   • Style: bold blocks (

     █

     )/thin lines (

     #

     /

     *

     )/no color
   • Border:

     ╔═╗║ ║╚═╝

     or plain text
   • Color scheme: Cyan → Purple (Spec Kit style), Cyan → Blue, Orange → Pink, etc.
2. Generate results
   • Generate by running the script directly (most reliable): see "Quick Start" below
   • Or generate in the target language as needed (Node/Python/Go), the core steps are:
     • First get the "monospace character art" (multi-line string)
     • Then do border splicing
     • Then apply character-by-character gradient (output ANSI TrueColor sequences)
3. Integrate into CLI
   • Output once when the entry point (

     main

     /

     bin

     /

     __main__

     ) starts
   • Support disabling color:
     • Respect

       NO_COLOR=1

     • Provide

       --no-color

       parameter
     • Disable by default in CI environment (can be enabled as needed)

Quick Start (Script)

python3 scripts/generate_logo.py --text auto-cli --subtitle "Command Line Interface"

python3 scripts/generate_logo.py \
  --text auto-cli \
  --subtitle "Command Line Interface" \
  --width 46 \
  --palette spec-kit \
  --frame box

Delivery Format

• Plain text (no color): suitable for README / logs / environments that don't support ANSI
• ANSI color text: suitable for CLI startup pages (it is recommended to provide

  --no-color

  switch)
• It is recommended to provide all of the following:

  • banner.txt

    (no color)

  • banner.ansi.txt

    (with color)

  • renderBanner()

    (output according to environment in your CLI)

References

• For color scheme and compatibility suggestions, see palettes.md