Liminal — CLI Reference

Commands

Command	Description
`liminal -p "prompt"`	Generate with a prompt
`liminal -p "idea" -m 10 -o ./output`	Custom iterations + output directory
`liminal -p "idea" --use-swarm --swarm-mode hybrid`	Swarm generation
`liminal -p "ambient glitch" --mode live-music`	Live music mode
`pnpm gui`	Launch Studio, the chat-first GUI with same-screen preview
`liminal chat`	Conversational creative session
`liminal bubbletea`	Operator TUI for deeper local workflows (requires pre-built Go binary)
`pnpm run tui`	Build + launch Bubble Tea TUI (auto-compiles Go)
`liminal fix <file\|desc>`	Auto-fix code with LLM
`liminal consolidate`	Memory consolidation
`liminal list`	List saved sketches
`liminal serve 3456`	Preview server on port
`liminal --configure`	Interactive configuration setup

Creative material digestion pipeline.

Command	Description
`liminal compost add <path>`	Feed material to the heap
`liminal compost digest`	Run full digestion pipeline (extract → shred → collide → score → promote)
`liminal compost soup start`	Start evolutionary soup on seeds
`liminal compost soup stop`	Stop the soup
`liminal compost seeds list`	Browse promoted creative seeds
`liminal compost seeds show <id>`	Show seed details
`liminal compost status`	Overview of heap, seeds, and soup

Self-hosting task system for structured improvements.

Command	Description
`liminal ledger list`	List all tasks in the corpus
`liminal ledger show <id>`	Show task details and requirements
`liminal ledger run <id>`	Execute a task
`liminal ledger verify <id>`	Verify task result
`liminal ledger status`	Ledger overview and statistics

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

Two methods: config file or environment variables.

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

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

Preferred cloud

Supported

Supported

Supported

Local

Router

Supported

Coding

Legacy

OpenAI-compatible

Interactive commands available in liminal chat and Bubble Tea TUI.

Script	Description
`pnpm run tui`	Build + launch Bubble Tea TUI (auto-compiles Go)
`pnpm run tui:bridge`	Start bridge server only (no Go client)
`pnpm test`	Run test suite
`pnpm run test:coverage`	Run tests with coverage
`pnpm run typecheck`	TypeScript type checking
`pnpm run lint`	ESLint
`pnpm run build`	Compile TypeScript