Axiom documentation

One CLI for shipping iOS and Android apps and driving software from your terminal and your AI agents.

Overview

Axiom is one command, axiom, with five areas. Each speaks JSON (--output json), and axiom phone ships an MCP server, so people and agents use the same tools.

Install

curl -fsSL https://axiom.synquic.cloud/install.sh | bash

brew install whyparv/axiom/axiom

irm https://axiom.synquic.cloud/install.ps1 | iex

Quickstart

axiom --help                       # all areas
axiom ios auth login --name MyKey --key-id KEY_ID \
  --issuer-id ISSUER_ID --private-key AuthKey_KEY_ID.p8
axiom ios status --app APP_ID      # one-screen release overview
axiom ios search "upload a build"  # find the command you need

Any flag value accepts @env:NAME or @file:PATH. Add --help to any command for its flags.

axiom ios

A fast CLI for App Store Connect. Sign in with an API key from appstoreconnect.apple.com.

Key commands

• auth · manage App Store Connect API keys · doctor diagnoses auth
• apps, status · list apps, one-screen release overview
• builds upload · upload an IPA/PKG via the presigned-URL API (works on Windows)
• analytics, finance, ads, insights, performance
• search "..." · find any command with examples

axiom ios builds upload --ipa App.ipa --app 1234567890
axiom ios apps list --output table

axiom android

A CLI for Google Play Console. Authenticate with a service-account JSON.

• release · create edit, upload bundle/APK, configure track, commit, in one command
• promote, rollout · move releases between tracks, staged rollouts
• tracks, bundles, apks, listings, sync
• validate · release-readiness report · status · release-health snapshot

axiom android release --track internal --bundle app.aab
axiom android promote --track production

axiom build

Build, sign and install iOS apps without Xcode (macOS and Linux).

• setup, auth, sdk · configure the toolchain and Apple Developer sign-in
• new, dev · create and build a SwiftPM app project
• devices, install, launch, uninstall

axiom build setup
axiom build dev build --configuration release

axiom phone

An interactive iPhone (simulator or paired device) in your terminal, driveable by you and your agents.

• up, view, status, stop · boot and show a phone, in a split pane
• action tap/swipe/type/button · drive it · action describe lists elements
• run, logs, record, test flows/, replay
• appstore screenshot/record · exact App Store Connect sizes

axiom phone up --device 'iPhone 17 Pro'
axiom phone action tap 180 420
axiom phone test flows/

axiom hub

A package manager for agent-ready CLIs. The hub lets you and your agents browse a catalog of command-line interfaces for apps and services, install them, and run curated multi-tool workflows, so an agent can reach for the right CLI without you wiring each one by hand.

Browse and install

• list · list every CLI in the catalog
• search "..." · search by name, description or category
• info <name> · show details for one CLI
• install <name> · install a CLI · update / uninstall
• launch <name> · run an installed CLI, passing through arguments

axiom hub list
axiom hub search "database"
axiom hub install <name>
axiom hub launch <name> -- --help

Capabilities and matrices

• can "<task>" · find, across all tools, which CLI can do a task
• matrix · browse and install curated multi-CLI workflow matrices (ready-made toolkits for a job)
• previews · inspect preview bundles and live sessions

axiom hub can "resize an image"
axiom hub matrix list

Agents & MCP

Every command speaks JSON (--output json), axiom phone ships an MCP server, and axiom ios search lets an agent discover commands, so Claude and other agents drive Axiom with the same commands you do. Agents get structured output, element references that reject stale screens, and receipts that never replay uncertain input.

• Use --output json on any command for machine-readable results.
• axiom ios search "..." lets an agent discover the right command.
• Connect the Axiom MCP server so your agent can call Axiom directly.

Connect the MCP server

Axiom ships an MCP server. Run it over stdio for desktop agents, or over HTTP to get a URL other tools connect to.

# stdio (Claude Desktop / Claude Code):
claude mcp add axiom -- axiom mcp

# HTTP on a port, gives a connectable URL:
axiom mcp --http :7399
# -> http://localhost:7399/mcp

Tools exposed: axiom_run (run any Axiom command) and axiom_search (discover the right command). Destructive actions still require an explicit --confirm.

Safeguards

Destructive and outward-facing actions are gated, so an agent cannot quietly do something irreversible:

• Delete, overwrite and submit operations require an explicit --confirm flag.
• --dry-run previews uploads and releases without sending anything.
• Real-device control in axiom phone stays view-only until you, the owner, allow control.
• Credentials never ship in the binary; they live in your OS keychain.