← all repositories
charmbracelet/mods

Pipe text to LLMs from the terminal — while you still can

Mods exists to wedge large language models into Unix pipelines, letting you query and format command output without leaving the terminal.

4.5k stars Go Coding Assistants
mods
Not currently ranked — collecting fresh signals.
star history

What it does

Mods reads standard input, prepends your prompt arguments, and sends the text to an LLM, printing the response so you can transform command output into Markdown, JSON, or plain text. It acts as a pipeline filter, working with local models through LocalAI or hosted APIs including OpenAI, Groq, Cohere, Azure, and Gemini.

The interesting bit

Conversations are saved locally with SHA-1 identifiers and titles—styled after git commits—and can be resumed or reviewed later. The tool also supports custom YAML-defined roles, such as a “shell” role that emits only one-liner commands without explanation, and recently added MCP server integration.

Key highlights

  • Built for pipelines: consumes stdin and writes formatted responses to stdout
  • Supports multiple backends: LocalAI, OpenAI, Cohere, Groq, Azure OpenAI, and Gemini
  • Persistent conversations with SHA-1 IDs and continuation flags
  • Custom system prompts via YAML roles
  • MCP server listing and tool discovery

Caveats

  • The project is officially sunsetting on March 9, 2026; Charm is shifting focus to Crush and its non-interactive crush run mode
  • Much of the current functionality is expected to migrate to Crush, so new feature investment here has ended

Verdict

Grab it if you want a lightweight, pipe-friendly LLM client today and don’t mind migrating later—or if you’re interested in maintaining a fork. Otherwise, keep an eye on Crush’s non-interactive mode.

Frequently asked

What is charmbracelet/mods?
Mods exists to wedge large language models into Unix pipelines, letting you query and format command output without leaving the terminal.
Is mods open source?
Yes — charmbracelet/mods is open source, released under the MIT license.
What language is mods written in?
charmbracelet/mods is primarily written in Go.
How popular is mods?
charmbracelet/mods has 4.5k stars on GitHub.
Where can I find mods?
charmbracelet/mods is on GitHub at https://github.com/charmbracelet/mods.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.