Mods
AI on the command line from Charm, built for pipelines.
Overview
Mods is a small CLI that adds AI to Unix pipelines, letting you pipe command output to an LLM and format the result as Markdown. It supports OpenAI, Anthropic, Gemini, Groq, Ollama and other OpenAI-compatible APIs.
- Pipe-friendly
- Markdown output
- Conversation saving
- Multiple providers
Our verdict
What we like
- Elegant Unix integration
- Lightweight
Watch out for
- Basic compared to agents
Works with these providers
Keys from these providers work in this app. Usage is billed by the provider at its list price.
BYOK Key Safety Score
Key handling in Mods
Grade A
Your key is stored on your device and requests go directly to the provider.
- Key storage40/40
Key stays on your device; requests go direct to the provider.
- Auditable code25/25
Open source: anyone can verify how keys are handled.
- Self-hosting8/15
Runs as a local app, but not as a self-hosted service.
- Offline option10/10
Supports local models, so no key is needed at all for private work.
- Provider choice10/10
7 provider options, which lets you pick the provider whose data terms you trust.
Whatever the score, give each app its own key, set a monthly spend limit with your provider, and revoke keys you no longer use. Read the key-safety checklist.
Mods FAQ
- Does Mods support bring your own key?
- Yes. Mods accepts your own API key from OpenAI, Anthropic, Google Gemini, Groq, Ollama, Azure OpenAI and OpenAI-compatible. Usage is billed by the provider at its API rates.
- Where does Mods store my API key?
- On your device. Requests go directly from Mods to the provider. Its BYOK Tools Key Safety Score is 93/100.
- Is Mods free?
- Open source: Free & open source. API usage is billed separately by your model provider.
- Is Mods open source?
- Yes. The source code is at https://github.com/charmbracelet/mods.
- Can Mods run local models?
- Yes. It can connect to local runtimes such as Ollama or LM Studio, so no API key is needed for private or offline use.
- Which platforms does Mods support?
- CLI, macOS, Windows, Linux.
Community reviews
No reviews yet.
Alternatives to Mods
All command line →Fabric
Command Line
Open-source framework of crowdsourced AI prompts for the CLI.
AIChat
Command Line
All-in-one LLM CLI with chat REPL, RAG, agents and a local server.
Open Interpreter
Command Line
Let language models run code on your computer from a terminal.
LLM (Simon Willison)
Command Line
CLI and Python library for interacting with any LLM.
gptme
Command Line
Personal AI agent in your terminal with code execution.
Wave Terminal
Command Line
Open-source terminal with inline AI chat and graphical widgets.