arborium-cli 2.6.0

Command-line syntax highlighter powered by arborium
arborium-cli-2.6.0 is not a library.

arborium-cli

A terminal-friendly syntax highlighter powered by Tree-sitter.

Features

  • ANSI terminal output - Beautiful syntax highlighting in your terminal
  • HTML output - Generate highlighted HTML for web pages
  • Auto-detection - Automatically detects language from filenames or shebangs
  • Multiple themes - Choose from 12 built-in themes
  • Flexible input - Highlight files, stdin, or literal code strings

Installation

cargo install arborium-cli

Usage

# Highlight a file (auto-detects language from extension)
arborium file.rs

# Highlight from stdin
cat file.py | arborium -

# Highlight with explicit language
arborium --lang javascript "const x = 42;"

# Generate HTML output
arborium --html index.js

# Use a specific theme
arborium --theme dracula script.sh

Options

  • -l, --lang <LANGUAGE> - Specify the language explicitly (e.g., rust, python, javascript)
  • --html - Output HTML instead of ANSI escape sequences
  • --theme <THEME> - Choose a color theme for ANSI output (see below)
  • <input> - Input source: filename, - for stdin, or literal code string

Available Themes

Catppuccin variants:

  • mocha / catppuccin-mocha (default)
  • latte / catppuccin-latte
  • macchiato / catppuccin-macchiato
  • frappe / catppuccin-frappe

Other themes:

  • dracula
  • tokyo-night
  • nord
  • one-dark
  • github-dark
  • github-light
  • gruvbox-dark
  • gruvbox-light

Examples

# Compare different themes
arborium --theme nord mycode.rs
arborium --theme dracula mycode.rs

# Highlight a script with shebang detection
arborium script.py  # Detects Python from .py extension
echo '#!/usr/bin/env python3\nprint("hello")' | arborium -  # Detects from shebang

# Generate HTML for a blog post
arborium --html snippet.rs > highlighted.html

# Pipe code through arborium
git diff | arborium --lang diff

Language Auto-Detection

Arborium attempts to detect the language in this order:

  1. Explicit --lang flag (highest priority)
  2. File extension - If input is a file path
  3. Shebang line - For stdin or literal strings (e.g., #!/usr/bin/env python3)

Supported languages include Rust, Python, JavaScript, TypeScript, C, C++, Go, Java, and many more.

License

See the main arborium repository for license information.