whatisgithub

What is mods?

charmbracelet/mods — explained in plain English

Analysis updated 2026-06-26

4,520GoAudience · developerComplexity · 2/5Setup · easy

In one sentence

A command-line tool that pipes text to AI models directly in your terminal. Great for scripting, summarizing command output, or asking AI questions without leaving the shell. Now archived, the team moved on to a tool called Crush.

Mindmap

mindmap
  root((mods))
    AI Providers
      OpenAI
      Groq
      Cohere
      LocalAI
    Core Usage
      Pipe text in
      Ask questions
      Shell scripts
    Conversations
      Save locally
      List and resume
      Delete old chats
    Customization
      Custom roles
      System prompts
      Model selection
    Integrations
      MCP servers
      External data sources
    Project Status
      Archived March 2026
      Successor Crush
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Summarize the output of a terminal command by piping it straight into an AI model

USE CASE 2

Use inside shell scripts to reformat, classify, or explain text automatically

USE CASE 3

Ask quick questions about any text without switching out of the terminal

USE CASE 4

Define reusable AI personas (like a shell-command helper) for repeated tasks

What is it built with?

GoOpenAI APIGroqCohereAzure OpenAILocalAIMCP

How does it compare?

charmbracelet/modsgoravel/goravelmodelcontextprotocol/go-sdk
Stars4,5204,5214,524
LanguageGoGoGo
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Archived as of March 2026, no longer maintained. Install the binary, set your API key, and pipe text in. For new projects, consider the successor tool Crush instead.

Open source, code is public and free to fork or modify.

So what is it?

Mods was a command-line tool that let you send text to an AI language model directly from your terminal, making it useful inside shell scripts and pipelines. The core idea was simple: pipe any text into Mods, add a question or instruction as an argument, and it would forward everything to an AI model and print the response. This made it easy to do things like summarize command output, reformat data, or ask questions about text without leaving the terminal. The tool supported several AI providers, including OpenAI, Cohere, Groq, Azure OpenAI, and locally running models via LocalAI. You could choose which model to use via a flag, or be prompted to pick one interactively. Conversations were saved locally by default, each with a short identifier and a title similar to how Git tracks commits. You could list saved conversations, continue a previous one, or delete old ones. For repeated use cases, you could define custom roles in a settings file. A role is a named system prompt that shapes how the AI responds. For example, a shell role might instruct the model to only output single-line commands with no explanation. The tool also had support for Model Context Protocol servers, which is a way of connecting AI tools to external data sources or capabilities. As of March 2026, the project has been archived and is no longer maintained. The team behind it has moved focus to a different tool called Crush, which includes a non-interactive mode called crush run that covers much of what Mods did. The repository remains public and the code is open source for anyone who wants to fork it.

Copy-paste prompts

Prompt 1
I want to replicate what Mods did, pipe terminal output to an AI in a shell script. Show me how to do that using the OpenAI API in a bash script.
Prompt 2
How do I set up a custom role in Mods so the AI only responds with single-line shell commands and no explanation?
Prompt 3
Mods is archived and the team moved to Crush. What does 'crush run' do and how do I migrate my Mods workflows to it?
Prompt 4
How does Mods store saved conversations locally, and how can I back them up or move them to another machine?
Prompt 5
I want to connect Mods to a local AI model using LocalAI. Walk me through the configuration steps.

Frequently asked questions

What is mods?

A command-line tool that pipes text to AI models directly in your terminal. Great for scripting, summarizing command output, or asking AI questions without leaving the shell. Now archived, the team moved on to a tool called Crush.

What language is mods written in?

Mainly Go. The stack also includes Go, OpenAI API, Groq.

What license does mods use?

Open source, code is public and free to fork or modify.

How hard is mods to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mods for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.