The nmux CLI - Your AI Knowledge Multiplexer

One tool to manage all your AI coding assistants

See Installation instructions

Core Capabilities

Package Management

  • Install, update, remove packages
  • Dependency resolution
  • Version locking and ranges

Multi-Tool Support

  • Auto-detection of installed AI tools
  • Manual tool selection option
  • Seamless configuration sync

Workspace Management

  • Project-level installations
  • Global installations
  • Configuration files

Command reference

Essential commands with examples

nmux init

Initialize project

nmux install

Install packages

nmux deploy

Deploy the knowledge from packages

nmux publish

Share your knowledge

nmux list

View installed packages

nmux update

Update packages

nmux search

Find packages

Installation Guide

1. Quick Install

Get started quickly with a single command. Perfect for trying out nmux.

View documentation

2. Detailed Setup

System requirements, installation methods, configuration options, troubleshooting.

View documentation

CLI FAQ

How do I install the nmux CLI?
You can install nmux using npm (npm install -g nmux), Homebrew (brew install nmux), or by downloading the binary directly from our releases page. The CLI works on macOS, Linux, and Windows.
What's the difference between nmux install and nmux deploy?
nmux install downloads packages to your local .nmux directory and updates your mux.yaml. nmux deploy takes the installed packages and configures your AI tools (Claude Code, Cursor, etc.) to use them. Think of install as downloading, and deploy as activating.
Can I use nmux offline?
Yes! Once packages are installed locally, nmux deploy works entirely offline. Only nmux install, nmux update, and nmux search require an internet connection to communicate with the registry.
How do I update all my packages at once?
Run nmux update without any arguments to check and update all packages to their latest compatible versions. Use nmux update --dry-run to preview changes before applying them.
What AI tools does the CLI support?
nmux currently supports Claude Code, GitHub Copilot, Cursor, Windsurf, and Cline. The CLI auto-detects which tools you have installed and configures them automatically when you run nmux deploy.
How do I publish my own package?
Create a mux.yaml in your project, add your instructions and configurations, then run nmux publish. You'll need to be logged in (nmux login) and have a registered namespace to publish packages.

Install nmux CLI in 30 seconds

Installing and trying out nmux is fast and easy. Try now for free!

Install nmux CLIExplore the registryRead documentation