# mods

> CLI tool that adds AI capabilities to command line pipelines by processing stdin through LLMs

Stars: 4.5k · Language: Go · License: MIT · Categories: AI · Status: archived

- Repository: https://github.com/charmbracelet/mods
- Page: https://www.trmn.sh/tools/mods

## Install

- Homebrew: `brew install charmbracelet/tap/mods`
- Go: `go install github.com/charmbracelet/mods@latest`
- Winget: `winget install charmbracelet.mods`

## Overview

Mods is a command-line tool that integrates Large Language Models into Unix pipelines by reading from standard input and processing it through AI models. It accepts text from stdin, combines it with user-provided prompts, sends the combined input to an LLM, and outputs formatted results in Markdown, JSON, or other text formats. The tool supports multiple AI providers including OpenAI, LocalAI, Cohere, Groq, Azure OpenAI, and Google Gemini.

The tool maintains conversation history locally, with each conversation identified by SHA-1 hashes and titles. Users can continue previous conversations, list saved sessions, and manage conversation storage. Mods includes features like custom roles for system prompts, output formatting options, model selection, and configurable parameters like temperature and token limits.

Mods works with OpenAI-compatible endpoints and defaults to supporting OpenAI's API and LocalAI installations on port 8080. It includes shell completions for Bash, ZSH, Fish, and PowerShell, making it suitable for developers and system administrators who want to incorporate AI processing into their command-line workflows. The tool is being sunset in March 2026 in favor of Charm's Crush project.

### Installation

```bash
# via Homebrew
brew install charmbracelet/tap/mods
```

```bash
# via Go
go install github.com/charmbracelet/mods@latest
```

```bash
# via Winget
winget install charmbracelet.mods
```

![Mods CLI usage demonstration](https://media.trmn.sh/cached/5f74856a0e0a6558615ea2af8cff38db25520efcd27c52effa29ca8888848b79.gif)

![Saved conversations interface](https://media.trmn.sh/cached/0ec04a5a836435464383869c98402e5819128d6ab2b96b82f56db7916f58e91f.gif)

## Alternatives

- [kubectl-ai](https://www.trmn.sh/tools/kubectl-ai.md): Terminal assistant that turns natural-language requests into kubectl and bash operations using Gemini, OpenAI, Bedrock, Ollama and other LLM providers. (Go, 7.6k stars)
- [Claude Squad](https://www.trmn.sh/tools/claude-squad.md): Terminal UI that runs multiple AI coding agents (Claude Code, Codex, Gemini, Aider) in parallel, each in its own tmux session and git worktree. (Go, 8.7k stars)
- [Crush](https://www.trmn.sh/tools/crush.md): Terminal-based agentic coding assistant from Charm that connects to many LLM providers, uses LSPs for context, and extends via MCP servers. (Go, 28.9k stars)
- [DeepSeek-Reasonix](https://www.trmn.sh/tools/deepseek-reasonix.md): Open-source coding agent shipped as a single Go binary with a TUI, desktop app, and ACP editor integration; DeepSeek preset, any OpenAI-compatible model. (Go, 36.0k stars)
- [Ollama](https://www.trmn.sh/tools/ollama.md): CLI tool for running and managing local large language models with REST API and client library support (Go, 185.7k stars)

---

Canonical: https://www.trmn.sh/tools/mods