CLI Reference

All commands, flags, and configuration options for the Sinter CLI.

Commands

CommandDescription
sinter -p "prompt"Generate with a prompt
sinter -p "idea" -m 10 -o ./outputCustom iterations + output directory
sinter -p "idea" --use-swarm --swarm-mode hybridSwarm generation
sinter -p "ambient glitch" --mode live-musicLive music mode
pnpm guiLaunch Studio, the chat-first GUI with same-screen preview
sinter chatConversational creative session
sinter bubbleteaOperator TUI for deeper local workflows (requires pre-built Go binary)
pnpm run tuiBuild + launch Bubble Tea TUI (auto-compiles Go)
sinter fix <file|desc>Auto-fix code with LLM
sinter consolidateMemory consolidation
sinter listList saved sketches
sinter serve 3456Preview server on port
sinter --configureInteractive configuration setup

Compost Mill

Creative material digestion pipeline.

CommandDescription
sinter compost add <path>Feed material to the heap
sinter compost digestRun full digestion pipeline (extract → shred → collide → score → promote)
sinter compost soup startStart evolutionary soup on seeds
sinter compost soup stopStop the soup
sinter compost seeds listBrowse promoted creative seeds
sinter compost seeds show <id>Show seed details
sinter compost statusOverview of heap, seeds, and soup

Task Ledger

Self-hosting task system for structured improvements.

CommandDescription
sinter ledger listList all tasks in the corpus
sinter ledger show <id>Show task details and requirements
sinter ledger run <id>Execute a task
sinter ledger verify <id>Verify task result
sinter ledger statusLedger overview and statistics

Flags

FlagDescription
-p, --prompt <text>Generation prompt
-m, --max-iterations <n>Max iterations (default: 3)
-o, --output <path>Output directory
--mode <mode>Mode: live-music
--use-swarmEnable swarm generation
--swarm-mode <mode>Swarm strategy: competitive, hybrid, ring, mesh
--voiceUse microphone for audio input
--voice-file <path>Use audio file for input
--aesthetic <preset>Guardrail preset: lenient, moderate, strict
--intuitionEnable intuition scoring dimension
-v, --verboseVerbose output

Configuration

Two methods: config file or environment variables.

Config File

Located at ~/.liminal/config.json. Created via sinter --configure.

{
  "llm": {
    "baseUrl": "https://api.minimax.io/anthropic",
    "model": "MiniMax-M2.7",
    "apiKey": "your-key"
  }
}

Environment Variables

VariableDescription
LLM_API_KEYAPI key for the provider
LLM_MODELModel name (e.g. MiniMax-M2.7)
LLM_BASE_URLAPI base URL
LIMINAL_LLM_MODELOverride model on the fly

Supported Providers

MiniMax

Preferred cloud

OpenAI

Supported

Anthropic

Supported

Google

Supported

Ollama

Local

OpenRouter

Router

GLM / ZhipuAI

Supported

Kimi Code

Coding

Moonshot AI

Legacy

Custom

OpenAI-compatible

TUI Slash Commands

Interactive commands available in sinter chat and Bubble Tea TUI.

CommandAction
/helpShow available commands
/statusSystem and harness status
/fix <description>Auto-fix code with LLM
/evaluate <file>Run evaluation on a file
/provider <name>Switch LLM provider
/mode <mode>Switch generation mode
/compost statusCompost Mill overview
/seeds listBrowse creative seeds
/ledger statusTask ledger overview
/consolidateRun memory consolidation
/quitExit session

npm Scripts

ScriptDescription
pnpm run tuiBuild + launch Bubble Tea TUI (auto-compiles Go)
pnpm run tui:bridgeStart bridge server only (no Go client)
pnpm testRun test suite
pnpm run test:coverageRun tests with coverage
pnpm run typecheckTypeScript type checking
pnpm run lintESLint
pnpm run buildCompile TypeScript