Loading documentation...
Loading documentation...
TachiBot provides beautiful terminal themes for ANSI output styling. Choose from 4 built-in themes or create your own custom themes via JSON.
Set your theme via environment variable:
Inspired by VS Code, Linear, and Vercel. Soft pastels that are easy on the eyes for long sessions.
#5F87FF(primary)#5FAF5F(success)#FFAF5F(accent)#FF5F5F(error)High contrast neon on black. Blade Runner vibes with bold HUD-style elements.
#FF00FF(primary)#00FFFF(secondary)#FFFF00(accent)#00FF00(success)Swiss typography-inspired. Mostly monochrome with color only where essential.
#FFFFFF(primary)#CCCCCC(secondary)#888888(muted)#666666(border)Cool blues and teals. Calm and professional aesthetic.
#00CED1(primary)#4169E1(secondary)#00FA9A(success)#FFD700(warning)Each theme defines consistent styling for:
Styled badges for AI providers using ink-gradient. Each model has a unique gradient preset for visual distinction:
Hierarchical heading styles with color-coded backgrounds (nebula/ocean) or text styling (cyberpunk/minimal).
Success, error, warning, and info badges with appropriate color coding for each theme's palette.
Thin/thick dividers, 256-color gradients (blue-to-purple, cyan-to-magenta, rainbow), and decorative separators.
Table characters and code block borders: rounded, sharp, or double-line styles depending on theme.
TachiBot themes use Nerd Fonts for rich terminal icons. These are patched fonts that include glyphs from Font Awesome, Devicons, Octicons, Powerline, and more.
After installing, set your terminal's font to the Nerd Font variant (e.g., "JetBrainsMono Nerd Font").
TachiBot uses Nerd Font icons for model badges, status indicators, and UI elements:
nf-md-diamond — Gemininf-md-lightning_bolt — Groknf-md-circle — OpenAInf-md-compass — Perplexitynf-md-check_circle — Successnf-md-close_circle — Errornf-md-alert — Warningnf-md-folder — Directorynf-md-file — FileBrowse all icons at nerdfonts.com/cheat-sheet
TachiBot gracefully falls back to ASCII characters if Nerd Fonts aren't detected. Icons become simple text like [✓], [✗], [!], etc.
Create custom themes by adding JSON files to the themes/ directory:
Model badges use gradient-string presets for TrueColor terminal gradients. Available presets:
cristalteenmindmorningvicepassionfruitatlasretrorainbowpastelinstagramOr use custom colors: "gradient": ["#ff0000", "#00ff00", "#0000ff"]
Use the extends property to inherit from a built-in theme. Only override what you need:
"extends": "nebula" - Inherit soft pastel base"extends": "cyberpunk" - Inherit neon aesthetics"extends": "minimal" - Inherit monochrome base"extends": "ocean" - Inherit blue paletteCustom themes support multiple color formats:
"#FF00FF""141" (number as string)"magenta", "cyan", "white"Preview themes in your terminal:
Match your TachiBot theme to your terminal's color scheme for the best visual coherence. Nebula works well with VS Code's default dark theme, Cyberpunk with Synthwave '84, and Ocean with One Dark Pro.
Control how TachiBot renders output with the RENDER_OUTPUT environment variable:
When TachiBot output is fed back into an LLM context, ANSI escape codes waste tokens and can confuse models. Enable ANSI stripping to automatically remove color codes from context while keeping beautiful terminal output for humans:
You see: \x1b[32m✓ Success\x1b[0m (green text)
LLM sees: ✓ Success (clean text)