lmc/AGENTS.md

aicl

Bun CLI tool for streaming LLM chat with inline markdown rendering.

Commands

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

Architecture

• index.ts — CLI entry point, orchestration
• src/render/index.ts — Renderer class: streams LLM response, buffers markdown, renders to stdout/stderr
• src/render/markdown.ts — renderMarkdown(): syntax-highlighted markdown via @comark/ansi + Shiki

Gotchas

• Bun only — not Node. Use Bun.file(), Bun.argv, Bun.sleep().
• No tests — none exist.
• Biome config: double quotes, space indent, auto-import-organize on. Run bun run check before committing.

Style

• Double quotes (enforced by biome).
• Preserve verbatimModuleSyntax — imports must be used or type-imported.
• strict: true in tsconfig.