lmc

A Bun-based CLI tool for LLM chats with terminal native streaming.

Features

• Streaming markdown rendering — incremental rendering with syntax highlighting
• Conversation persistence — chat history saved to JSON
• Model configuration — persist model preferences to JSON
• Reasoning display — thinking tokens rendered in style on stderr
• Usage stats — input/output tokens and elapsed time after each response
• TTY-aware — automatically disables markdown rendering when output is piped
• Text-to-speech — ttsc sub-command for streaming TTS via Kokoro model

Requirements

• Bun v1.3+
• uv — only for ttsc (text-to-speech)

Installation

bun install
bun build:js
bun link

# For ttsc only
cp -r tts ~/.ttsc

Package to come later

Usage

Chat (lmc)

lmc [options] <prompt...>

Flag	Short	Type	Description
--new	-n	boolean	Start a new conversation (clear history)
--model	-m	string	Set model name for this session
--save	-s	boolean	Save the specified model (--model) as the default
--plain	—	boolean	Disable markdown rendering (plain text output)
--plainOut	—	boolean	Disable markdown rendering for stdout only
--plainErr	—	boolean	Disable markdown rendering for stderr only

Examples:

lmc --new "Introduce yourself."              # New conversation
lmc "What is TypeScript?"                    # Continue most recent chat
lmc -m llama3 "Explain quantum computing"    # Chat with specific model
lmc --model llama3 --save                    # Set default model
lmc --plain "Plain text output"              # No markdown rendering

Text-to-Speech (ttsc)

echo "text" | ttsc [options]

Flag	Short	Type	Description
--wait	-w	boolean	Wait for all processing before exiting (don't auto-play)

Examples:

echo "Hello, world!" | ttsc
echo "Read this aloud" | ttsc --wait

Requires: uv

Wants:

• mpv for playback
• sox for wav merging with --wait

Development

bun run dev      # dev run
bun run prod     # run bundled output
bun run check    # biome lint + format + organize imports

Architecture

index.ts                — LMC entry point, orchestration
tts.ts                  — TTSC entry point, orchestration
src/render/index.ts     — Renderer class: streams LLM response, buffers markdown
src/render/markdown.ts  — renderMarkdown(): syntax-highlighted markdown via Bun.markdown + Shiki
src/conversation/       — Conversation persistence
src/config/             — App config persistence
tts/                    — TTS python stub (Kokoro pipeline)
out/                    — Bundled output (index.js, tts.js)

Configuration

• Conversation history: ~/.lmc_convo.json
• Model config: ~/.lmc_config.json
• TTS files: ~/.ttsc/

Dependencies

Package	Purpose
ai (Vercel AI SDK)	Streaming text/usage
@ai-sdk/openai-compatible	OpenAI-compatible API client
shiki	Syntax highlighting (kanagawa-wave theme)
cli-table3	ASCII table rendering
chalk	Terminal string styling
terminal-link	Clickable terminal hyperlinks