/ features

Everything axion
can do.

Axion is small on the outside, dense on the inside. The list below is the full surface area across the CLI, the HTTP server, the MCP server, and AxionBar.

01 engine

Plan, Execute, Verify, Replan.

The engine moves through five states: planning → executing → verifying → replanning → done. Verifying runs explicit stop-condition checks; replanning triggers automatically up to three times on failure.

axion run "Open Calculator and compute 123 + 456"
axion run --dryrun "..."     # generate plan, don't execute
axion run --fast "..."        # fewer LLM calls for simple tasks
axion run --max-steps 10 "..."
02 memory

Cross-run memory.

After every run, Axion extracts app operation patterns — menu paths, control positions, sequences — and persists them. On the next run for that app, the planner ships with experience baked in.

axion memory list
axion memory clear --app com.apple.calculator
axion run --no-memory "Open Calculator"
03 takeover

User takeover.

When automation can't make progress, Axion pauses and asks. Do the action manually, press Enter to resume. Type skip to drop the step, abort to cancel.

04 http

HTTP API server.

Run Axion as a long-lived service. Submit tasks over REST, stream progress via SSE, cap concurrency, gate access with an auth key.

axion server --port 4242 --auth-key mysecret --max-concurrent 3

GET  /v1/health
POST /v1/runs                 {"task": "..."}
GET  /v1/runs/{id}
GET  /v1/runs/{id}/events     # SSE event stream
05 mcp

MCP server mode.

Expose Axion as an MCP stdio server. Drop it into Claude Code's mcpServers config and other agents gain a desktop body.

{
  "mcpServers": {
    "axion": {
      "command": "/path/to/axion",
      "args": ["mcp"]
    }
  }
}
06 skills

Record and replay skills.

Record a workflow once, compile it into a deterministic skill, then replay it without any LLM calls. Skills are JSON in ~/.axion/skills and can take --param values.

axion record "open_calculator"
# ...perform desktop operations, Ctrl-C to stop
axion skill compile open_calculator
axion skill run open_calculator
axion skill list
07 windows

Multi-window workflows.

Coordinate operations across apps — copy from Safari to TextEdit, tile windows side by side, chain end-to-end workflows. The arrange_windows tool supports tile-left-right, tile-top-bottom, and cascade.

axion run "Copy the page title from Safari and paste it into TextEdit"
axion run "Put Safari and TextEdit side by side, Safari on the left"
08 menubar

AxionBar — native menu bar app.

Quick Run from the menu bar, real-time task panel via SSE, one-click skill triggers, global hotkeys, run history. Talks to the CLI backend through the HTTP API.