tree-sitter-ts-highlight-cli

Command-line wrapper for tree-sitter-ts-highlight.

Install

npm install -g tree-sitter-ts-highlight-cli

Or run with npx:

npx tree-sitter-ts-highlight-cli --help

Usage

hlts [options]

HTML highlight

hlts --input example.ts --language typescript --block --line-numbers > out.html

ANSI highlight (terminal)

hlts --input example.ts --ansi --line-numbers

Diff highlight (HTML)

hlts --diff --old before.ts --new after.ts --view side-by-side > diff.html

Options

• -i, --input <file>: input file path (default: stdin)
• -o, --output <file>: output file path (default: stdout)
• -l, --language <lang>: language name or extension
• --ansi: output ANSI-colored text
• --diff: output highlighted HTML diff (requires --old and --new)
• --block: wrap HTML output in <pre><code>
• --line-numbers: include line numbers
• --start-line <n>: set starting line number
• --semantic: enable semantic token enhancement
• --theme <name>: built-in HTML theme name (from tree-sitter-ts-highlight)
• --old <file>: old/original file for diff mode
• --new <file>: new/updated file for diff mode
• --view <mode>: side-by-side or inline (diff mode)
• --old-label <label>: label for old side header
• --new-label <label>: label for new side header
• --no-header: hide diff header row
• -h, --help: show help
• -v, --version: show version

Programmatic API

import { runCli, parseCliArgs } from "tree-sitter-ts-highlight-cli";

The package also re-exports all public APIs from tree-sitter-ts-highlight.

TypeScript types

This package also re-exports types from both tree-sitter-ts-highlight and tree-sitter-ts, so TypeScript libraries can consume those shared types directly:

import type { ThemeDefinition } from "tree-sitter-ts-highlight-cli";

Test

npm test

Watch mode:

npm run test:watch