# macOS — Homebrew (live now via our tap; in homebrew-cask review)
brew install --cask AzmxAI/azmx/azmx
# macOS / Linux — one-line installer (live)
curl -fsSL https://azmx.ai/install | sh
# Windows — winget (manifest submitted to microsoft/winget-pkgs; live after review)
winget install AzmxAI.AZMX
Or grab a signed installer for your platform from the latest release:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | AZMX.AI_<version>_aarch64.dmg |
| macOS (Intel) | AZMX.AI_<version>_x64.dmg |
| Linux | AZMX.AI_<version>_amd64.AppImage, .deb, or .rpm |
| Windows | AZMX.AI_<version>_x64_en-US.msi or *_x64-setup.exe |
Detailed walkthrough per platform: SETUP.md.
The application source is proprietary. This repository publishes release artifacts and user-facing docs — installers, the auto-updater manifest, and the community contribution surfaces (skills, agents, MCP servers, snippets, translations). Source contributions land upstream and ship to you via the auto-updater.
Prefer BYOK? Skip step 2's button and use the BYOK step instead. Both paths land at a working composer.
Your contribution ships to every AZMX user worldwide on next release. No CLA. You keep copyright. You grant a permissive license. The bundled distribution gets richer every month because of community work.
Five surfaces, every one of them a single Markdown (or JSON) file:
| Build a … | What it is | Where to start |
|---|---|---|
| 🤖 Skill | A discipline the agent loads on demand to act like a domain expert (e.g. "Postgres query review"). One Markdown file. | skills/ → SKILL_AUTHORING.md |
| 🧑🚀 Sub-agent | A specialist the main agent delegates to, with bounded tools + predictable output (e.g. test-writer, migration-planner). | agents/ → AGENT_AUTHORING.md |
| 🔌 MCP connector | A new tool the agent can call — bridge to your service, your data, your internal CLI. | mcp-servers/ → MCP_AUTHORING.md |
| ✨ Snippet | A pre-baked prompt template accessible via #name in the composer. | snippets/ → SNIPPET_AUTHORING.md |
| 🌍 Translation | The onboarding card in your language — 5 seeded, ~10 priority next. | TRANSLATIONS.md |
Plus: add a recipe to the cookbook, fix a doc, or showcase someone else's work.
Every contributor gets credit in release notes. Featured contributors get a complimentary Pro license; repeat featured contributors get Teams. Read the principles →
Two MIT-licensed packages ship under the @azmxailabs npm scope. Use them to make your AI assistant aware of AZMX, or to build your own approval-gated agent with the same primitives AZMX uses internally.
| Package | What it does | Install |
|---|---|---|
@azmxailabs/mcp  | Official Model Context Protocol server. Drop it into Claude Desktop, Claude Code, Cursor, Windsurf, Continue, OpenAI Codex CLI, Cline, or any other MCP client — and the assistant gains grounded, authoritative knowledge about AZMX (pricing, BYOK providers, security posture, comparisons, install steps, latest release). | npx -y @azmxailabs/mcp |
@azmxailabs/agent-sdk  | TypeScript SDK that ships the four primitives behind AZMX as standalone, dependency-free modules — approval gate, deny-list, hash-chained audit log, BYOK provider router. Build your own agent (CI script, CLI, desktop app, server) with the same security posture AZMX has, none of the UI. | npm install @azmxailabs/agent-sdk |
Step-by-step walkthrough for either package: docs/DEVELOPER-GUIDE.md
Full reference docs on the website:
Source: packages/ — pure TypeScript, Node ≥ 18, ESM, MIT.
| SETUP.md | Install per platform · first-run setup |
| MANUAL.md | Full feature reference — every panel, every shortcut |
| FAQ.md | Common questions on privacy, licensing, performance, models |
| CHANGELOG.md | Release notes (per-version detail on the releases page) |
| docs/TIERS.md | What's in Free / Pro / Teams / Enterprise |
| docs/MODELS.md | Supported AI providers · BYOK · local models |
| docs/CONNECTORS.md | The bundled MCP catalog · custom + workspace MCP |
| docs/AGENTS.md | What the agent can + can't do · approval gates · audit log |
| docs/KEYBINDINGS.md | Every shortcut, by category |
| docs/RECIPES.md | Workflow cookbook — copy + adapt |
| docs/GLOSSARY.md | Terms you'll see across the docs |
| docs/ROADMAP.md | What we're working on |
| SECURITY.md | Vulnerability reporting · what's protected |
| PRIVACY.md | What we collect (nothing, by default) · what lives where |
| LICENSE.md | EULA pointer · third-party notices · trademarks |
| CODE_OF_CONDUCT.md | How we behave on this project |
| CONTRIBUTING.md | How to engage with this repo |
| docs/COMPLIANCE.md | SBOM · SOC 2 · DPA · FIPS · PIV/CAC |
| docs/TELEMETRY.md | What gets sent (nothing, by default) |
| docs/AIRGAPPED.md | Run AZMX with zero outbound |
| docs/TROUBLESHOOTING.md | Problem → fix, by surface |
| docs/DATA_PORTABILITY.md | Export · backup · move between machines |
| docs/UNINSTALL.md | Clean removal per platform |
| docs/SUPPORT.md | Where to go for what |
| skills/ | Community skills the agent can load (load_skill("…")) |
| agents/ | Community sub-agents the main agent delegates to |
| mcp-servers/ | Community MCP connector manifests |
| snippets/ | Community prompt snippets (#name in the composer) |
| guidelines/ | Authoring standards for every contribution kind |
| guidelines/SHOWCASE.md | Featured community contributions |
| packages/ | Official npm packages — @azmxailabs/mcp + @azmxailabs/agent-sdk |
| docs/DEVELOPER-GUIDE.md | Step-by-step developer walkthrough for both npm packages |
AZMX checks for updates on launch. New versions land via the in-app updater — no need to revisit this page once you're installed. Signed via a public minisign key bundled with the app.
If AZMX saves you time, a star helps two things:
It costs you one click and supports a small team trying to build the AI terminal we wanted for ourselves. Thank you 🙏
(This space will fill in as AZMX is covered. Tell us if you wrote about AZMX →)
No reviews yet. Be the first to rate this tool.
Sign in to leave a review.