# Install mods with Homebrew, apk, Nix, scoop, winget AI on the command-line. Version 1.8.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:mods ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install mods ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add mods ``` Evidence: Alpine Linux edge package indexes: mods from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#mods ``` Evidence: nixpkgs package indexes: pkgs/by-name/mo/mods/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Scoop (92%): ```sh scoop install main/mods ``` Evidence: Scoop official bucket manifest trees: bucket/mods.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id charmbracelet.mods -e ``` Evidence: Windows Package Manager source index: charmbracelet.mods from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:mods - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.8.1 - **Source summary:** AI on the command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - mods (cli) - mods (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.8.1 - Local data: ok - Upstream repository: https://github.com/charmbracelet/mods - Upstream latest detected: v1.8.1 (current) - info: No package-manager update timestamp was available. ## Project history and usage Mods is Charm Bracelet's command-line LLM tool, described by the project as "AI for the command line, built for pipelines." It was designed around Unix standard input and output: read command output or a prompt, send it to an LLM, and print formatted text such as Markdown, JSON, shell-oriented answers, or saved conversation output. That made it part of Charm's broader terminal tooling family rather than a GUI chatbot or application SDK. ### Project history The tool grew around provider flexibility. The README documents OpenAI-compatible endpoints, LocalAI, OpenAI, Cohere, Groq, Azure OpenAI, and Gemini, plus configuration through a settings file and environment variables. It also includes command-line affordances such as selecting models, custom roles, conversation save/list/show/delete commands, Markdown formatting, proxy settings, shell completions, and package installs through Homebrew, Winget, Arch, Nix, Debian/RPM packages, FreeBSD ports, binaries, and `go install`. ### How it is used Charm announced that Mods was sunset and the repository archived on March 9, 2026 so the team could focus on Crush, with much of the non-interactive use case moving to `crush run`. That gives the package a clear historical place: an early pipeline-friendly AI CLI that helped normalize piping terminal output into LLMs, later superseded inside Charm's agentic terminal product line. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Linux: ~/.config/mods/mods.yml - macOS: ~/Library/Application Support/mods/mods.yml ## Credential files - Linux: ~/.config/mods/mods.yml - macOS: ~/Library/Application Support/mods/mods.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** mods - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - mods: normalized package name match | nixpkgs package indexes: pkgs/by-name/mo/mods/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - mods - 1.8.1-r8: normalized package name match | Alpine Linux edge package indexes: mods from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | AI for the command line, built for pipelines. | https://github.com/charmbracelet/mods - apk - mods-doc - 1.8.1-r8: normalized package name match | Alpine Linux edge package indexes: mods-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | AI for the command line, built for pipelines. (documentation) | https://github.com/charmbracelet/mods - Scoop - main/mods: normalized package name match | Scoop official bucket manifest trees: bucket/mods.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - charmbracelet.mods: normalized package name match | Windows Package Manager source index: charmbracelet.mods from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [gptme](https://www.automicvault.com/pkg/brew/gptme/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm, terminal. - [chatblade](https://www.automicvault.com/pkg/brew/chatblade/) - Shares av.db curated category or tags: ai, cli, developer-tools, terminal. - [context7-mcp](https://www.automicvault.com/pkg/brew/context7-mcp/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [fabric-ai](https://www.automicvault.com/pkg/brew/fabric-ai/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [gollama](https://www.automicvault.com/pkg/brew/gollama/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [localai](https://www.automicvault.com/pkg/brew/localai/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [repomix](https://www.automicvault.com/pkg/brew/repomix/) - Shares av.db curated category or tags: ai, cli, developer-tools, llm. - [navi](https://www.automicvault.com/pkg/brew/navi/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line. ## Combined YAML source View the package source record on GitHub. [combined/mods.yml](https://github.com/automic-vault/db/blob/main/combined/mods.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph