Instalacija

Jedan binary. Bez zavisnosti. 30 sekundi do prvog razgovora.

1

Instaliraj preko Homebrew (preporučeno)

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

Ili skini .pkg instaler (univerzalni binary, Intel + Apple Silicon).

2

Instaliraj .pkg (alternativa)

Instaler ubacuje m u /usr/local/bin/m. Ako macOS Gatekeeper baci upozorenje (nepotpisan .pkg), desni klik → Open, ili:

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

Pokreni čarobnjaka

Prvo pokretanje otvara setup wizard — biraš Ollama (lokalno, besplatno), Anthropic, OpenAI, Gemini, Alibaba ili LiteLLM.

$ m

# Izaberi backend, nalepi API ključ (ili preskoči za Ollamu), gotovo.

Provera

$ m --version
m version 0.1.1

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

Skini .zip

Preuzmi Windows amd64 zip sa poslednjeg release-a.

Preuzmi .zip
2

Raspakuj i dodaj u PATH

Raspakuj m.exe i premesti u folder koji je u PATH-u (npr. C:\Users\ti\bin\). Zatim dodaj taj folder u PATH: Settings → System → Advanced system settings → Environment Variables.

3

Pokreni čarobnjaka

Otvori novi PowerShell ili Command Prompt, pa pokreni:

PS> m

# Izaberi backend, nalepi API ključ, gotovo.

API ključevi se čuvaju u Windows Credential Manager-u — bez plaintext fajlova.

Provera

PS> m --version
m version 0.1.1

PS> m doctor
✓ Config: openai/gpt-4o
✓ API key: found
All checks passed!
1a

Skini .deb (Debian/Ubuntu)

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

Za ARM64 (Raspberry Pi, Graviton): uzmi _linux_arm64.deb umesto toga.

1b

Ili tarball (bilo koja distribucija)

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

Instaliraj secret-tool (za bezbedan keychain)

m koristi secret-tool za sigurno čuvanje API ključeva. Instaliraj ako nije prisutan:

$ sudo apt-get install -y libsecret-tools # Debian/Ubuntu
$ sudo dnf install libsecret # Fedora/RHEL
3

Pokreni čarobnjaka

$ m

# Wizard instalira Ollamu ako biraš lokalno, ili pita za API ključ.

Provera

$ m --version
m version 0.1.1

Desktop GUI je napravljen sa Wails (Go + Svelte). Deli isti config i sesije sa CLI-jem — koristi jedno, drugo, ili oba.

1

Preuzmi AgentCTL macOS aplikaciju

Preuzmi AgentCTL_*_macos.zip

Sadrži AgentCTL.app — univerzalni binary za Intel + Apple Silicon.

2

Raspakuj i premesti u Applications

$ cd ~/Downloads
$ unzip AgentCTL_*_macos.zip
$ mv AgentCTL.app /Applications/

Ako Gatekeeper blokira: desni klik na app → Open → Open anyway. Ili:

xattr -d com.apple.quarantine /Applications/AgentCTL.app
3

Pokreni i podesi

Otvori AgentCTL iz Launchpad-a ili Spotlight-a. Ako si već pokrenuo m u terminalu, config se automatski preuzima. Ako nije — Settings panel u aplikaciji nudi izbor provajdera i unos API ključa.

1

Kloniraj i buildaj

Treba ti Go 1.26+.

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

Dodaj u PATH

Binary se sleti u $(go env GOPATH)/bin/m. Postaraj se da to bude u PATH-u.

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

Buildaj desktop GUI (opciono)

Zahteva Wails i Node.js 20+.

$ go install github.com/wailsapp/wails/v2/cmd/wails@latest
$ cd Agentctl
$ make desktop-build

Provera

$ m --version
m version dev

Buildovi iz izvora pišu dev umesto verzije. Tako i treba.

Podešavanje

Konfiguracija

Wizard za prvo pokretanje
Pokreni m bez argumenata. Wizard te vodi kroz izbor provajdera i unos API ključa. Config se čuva u ~/.config/m/config.yaml (Linux/macOS) ili %APPDATA%\m\config.yaml (Windows). Ključevi su u OS keychain-u, nikad u plaintext-u.
Promena provajdera / modela
Pokreni m config da promeniš provajdera ili model interaktivno. Ili postavi M_MODEL env varijablu za jednokratni prelaz:

M_MODEL=openai/gpt-4o m "objasni ovo"
API ključevi preko env varijabli
Env varijable imaju prioritet nad keychain-om. Korisno za CI i Docker:

ANTHROPIC_API_KEY
OPENAI_API_KEY
GEMINI_API_KEY
DASHSCOPE_API_KEY (Alibaba)
LITELLM_API_KEY
Config po projektu
Stavi .m/config.yaml u root bilo kog repo-a da pregaziš globalni agent i model samo za taj projekat. m automatski traži fajl hoda up direktorijumskim stablom.

agent: devops
model: anthropic/claude-sonnet-4-5
Provera zdravlja
Pokreni m doctor da proveriš da li je sve ispravno: config fajl, API ključ, dostupnost modela, git. Otkrij probleme pre nego što postanu nejasne greške usred rada.
MCP serveri
Povezi se na GitHub, Jiru, Confluence i druge alate preko MCP-a. Pokreni m mcp setup github za automatsku instalaciju, ili pogledaj MCP dokumentaciju za ručno podešavanje.
Shell integracija

Shell kompletiranje

Tab-kompletiranje za sve m komande, flagove i imena agenata. Pokreni jednom, reload shell-a.

$ m completion bash >> ~/.bashrc
$ source ~/.bashrc
Šta dalje

Spreman si

Brzi start
Vidi AgentCTL u akciji — terminal demo, slash komande, pregled TUI-ja.
Primeri agenata
Pregledaj 42 gotova agenta za kod, DevOps, Jiru i više.
MCP serveri
Spoji se na Jiru, GitHub, Confluence i ostale eksterne alate.
Sesije
Automatski snimljene, enkriptovane, nastavljive. Nikad ne gubi kontekst.
Ostani ažuran

Ažuriranja

Automatsko obaveštenje
AgentCTL jednom dnevno proverava GitHub za novu verziju. Ako postoji, vidiš:

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

Nema blokiranja, keširano, tiho ako nema interneta.
Samo-ažuriranje
Pokreni m upgrade da ažuriraš CLI binary direktno — bez package manager-a. Radi na Linux, macOS i Windows.

Homebrew korisnici mogu i:
brew upgrade subzone/tap/m