# Install tmuxai with Homebrew, Nix AI-powered, non-intrusive terminal assistant. Version 2.3.1 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:tmuxai ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tmuxai ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#tmuxai ``` Evidence: nixpkgs package indexes: pkgs/by-name/tm/tmuxai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:tmuxai - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.3.1 - **Source summary:** AI-powered, non-intrusive terminal assistant - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T02:33:34Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - tmuxai (cli) - tmuxai (alias) ## Dependencies - tmux ## 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: 2.3.1 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/alvinunreal/tmuxai - Upstream latest detected: v2.3.1 (current) ## Project history and usage TmuxAI is a newer AI terminal assistant built around tmux rather than around a separate terminal emulator or chat UI. Its official documentation describes it as an assistant that lives inside tmux sessions, observes visible panes, chats in a dedicated pane, and can execute approved commands in a separate execution pane. ### Project history The project presents itself as part of the post-ChatGPT wave of command-line AI tools, but with a tmux-first design: it assumes the user's existing terminal workspace is already in tmux and uses that workspace as model context. The official README and site emphasize Unix-like systems, a single `tmuxai` command, configuration in `~/.config/tmuxai/config.yaml`, and installation via a shell installer, release binaries, Homebrew, or `go install` from the main branch. Because the upstream public history is still thin, the safest history claim is about design lineage rather than age: TmuxAI extends the tmux ecosystem from session management into AI-assisted terminal observation and controlled command execution. Its docs also include knowledge bases, model configuration, context squashing, MCP server tools, and watch/prepare modes, showing a tool aimed at long-running terminal workflows rather than one-shot prompts. ### Adoption history Package-manager adoption is visible in the supplied package facts: the project is packaged for Homebrew and Nix. That matters for this niche because tmux users often expect portable CLI tools to be installed into a dotfile-managed Unix environment, and Homebrew/Nix coverage puts TmuxAI in the same installation path as tmux itself. ### How it is used A typical use is to start `tmuxai` inside an existing tmux window, configure a model provider and API key, then ask for help while the assistant reads visible pane context. Its observe mode proposes commands and asks for confirmation before running them; prepare mode improves shell command tracking; watch mode monitors pane output for a stated goal. ### Why package nerds care For package nerds, TmuxAI is notable less as a mature historical utility and more as an example of AI tooling moving into established terminal multiplexers. It packages AI assistance as a normal Unix command with config files, Homebrew/Nix distribution, and tmux pane semantics, rather than as a proprietary terminal app. ### Timeline - Current: Official docs describe install-script, Homebrew, release-binary, and Go-from-main installation paths. - Current: Official docs describe observe, prepare, watch, knowledge-base, squashing, web fetch/search, and MCP server features. - 2026: Supplied package facts list Homebrew and Nix package-manager coverage. ### Related projects - Related to tmux as its host environment, and adjacent to terminal AI assistants that provide command suggestions or shell automation. - Related in workflow to tmux session tools such as tmuxinator and tmuxp, but focused on interactive AI assistance rather than declarative session layout. ### Sources - - - input source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for tmuxai. Nucleus package metadata is still published here so future coverage has a stable package URL. ## 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 - Unix: ~/.config/tmuxai/config.yaml, ~/.config/tmuxai/mcp.json ## Credential files - Unix: ~/.config/tmuxai/config.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tmuxai - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - tmuxai: normalized package name match | nixpkgs package indexes: pkgs/by-name/tm/tmuxai/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [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. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [fabric-ai](https://www.automicvault.com/pkg/brew/fabric-ai/) - Shares av.db curated category or tags: ai, automation, cli, developer-tools. - [gptscript](https://www.automicvault.com/pkg/brew/gptscript/) - Shares av.db curated category or tags: ai, automation, cli, developer-tools. - [aichat](https://www.automicvault.com/pkg/brew/aichat/) - Shares av.db curated category or tags: ai, cli, developer-tools. - [aider](https://www.automicvault.com/pkg/brew/aider/) - Shares av.db curated category or tags: ai, cli, developer-tools. - [chatblade](https://www.automicvault.com/pkg/brew/chatblade/) - Shares av.db curated category or tags: ai, cli, developer-tools. - [context7-mcp](https://www.automicvault.com/pkg/brew/context7-mcp/) - Shares av.db curated category or tags: ai, cli, developer-tools. - [docker-agent](https://www.automicvault.com/pkg/brew/docker-agent/) - Shares av.db curated category or tags: ai, automation, cli, developer-tools. - [gollama](https://www.automicvault.com/pkg/brew/gollama/) - Shares av.db curated category or tags: ai, cli, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/tmuxai.yml](https://github.com/automic-vault/db/blob/main/combined/tmuxai.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