Installation

One binary. No dependencies. 30 seconds to your first chat.

1

Install via Homebrew (recommended)

$ brew tap subzone/tap
$ brew install subzone/tap/m

Or download the .pkg installer (universal binary, Intel + Apple Silicon).

2

Double-click to install

The installer places m at /usr/local/bin/m. If macOS shows a Gatekeeper warning (unsigned .pkg), right-click → Open, or run:

xattr -d com.apple.quarantine ~/Downloads/m_*.pkg
3

Run the wizard

First launch opens a setup wizard — pick Ollama (local, free), Anthropic, OpenAI, Gemini, Alibaba, or LiteLLM.

$ m

# Pick your backend, paste an API key (or skip for Ollama), done.

Verify

$ m --version
m version 0.0.33

$ m doctor
✓ Config: alibaba/deepseek-v3.2
✓ API key: found
✓ git: found
All checks passed!
1

Download the .deb (Debian/Ubuntu)

$ wget https://github.com/subzone/Agentctl/releases/latest/download/m_0.0.33_linux_amd64.deb
$ sudo dpkg -i m_*_linux_amd64.deb

For ARM64 (Raspberry Pi, Graviton): grab _linux_arm64.deb instead.

1

Or download the tarball (any distro)

$ wget https://github.com/subzone/Agentctl/releases/latest/download/m_0.0.33_linux_amd64.tar.gz
$ tar -xzf m_*_linux_amd64.tar.gz
$ sudo mv m /usr/local/bin/
2

Run the wizard

$ m

# Wizard installs Ollama if you pick local, or prompts for an API key.

Verify

$ m --version
m version 0.0.33
1

Clone and build

Requires Go 1.26+.

$ git clone https://github.com/subzone/Agentctl.git
$ cd Agentctl
$ go install ./cmd/m
2

Add to PATH

The binary lands in $(go env GOPATH)/bin/m. Make sure that's in your PATH.

$ export PATH="$PATH:$(go env GOPATH)/bin"

Verify

$ m --version
m version dev

Source builds report dev instead of a version number.

What's next

You're ready to go

Quickstart
See AgentCTL in action — terminal demo, slash commands, TUI overview.
Example Agents
Browse 20+ ready-to-use agents for coding, DevOps, and more.
MCP Servers
Connect to Jira, GitHub, Confluence and other external tools.
Staying current

Auto-update notifications

AgentCTL checks GitHub for new releases once per day. If a newer version exists, you'll see:

↑ update available: v0.0.29 → v0.0.33 (brew upgrade subzone/tap/m)

Non-blocking, cached, silent on errors. To upgrade:

brew upgrade subzone/tap/m