All notable changes to axme-cli are documented in this file.
This project follows Semantic Versioning. During alpha (0.x.y), breaking changes may occur in minor version bumps.
axme intents cleanup --status— filter which statuses to target during bulk cleanup (default: DELIVERED, WAITING, IN_PROGRESS, SUBMITTED, ACKNOWLEDGED). (#83)
- Bulk cleanup timeout increased — HTTP timeout for
axme intents cleanupraised from 60s to 300s to handle large batches without hanging. (#83)
- Scenario watch SSE delay — reduced
wait_secondsfrom 30s to 5s in intent event stream, cutting worst-case delay after email approval from ~30s to ~5s. (#85)
axme mesh dashboard— opens the Agent Mesh dashboard (mesh.axme.ai) in the browser with automatic SSO. Creates a one-time exchange token, opens the browser. Supports--no-browserand--jsonflags. (#81)
- README redesigned with hero section and output demo (#78, #79, #80)
- macOS: agent key lookup used wrong path —
loadAgentKeyhardcoded~/.configbut macOS uses~/Library/Application Support; now uses canonicalscenarioAgentsStorePath()(#73) - macOS: SSE race in
examples run— agents started after intent was created; SSE init phase skipped the delivery event on high-latency connections. Agents now start beforescenarios apply(#74) - Install script:
ensure_pathfalse positive — runtime PATH check returned early when user had a temporaryexport; now checks rc file only (#72) - Install script and all docs now include a generic "source" hint after install command
- Tier naming:
email_verified→ Starter,corporate→ Business in all user-facing text (#69) --tierflag accepts both old (email_verified,corporate) and new (starter,business) namesquota showdisplays friendly tier name (Starter/Business)
- 8 raw HTTP response body leaks replaced with user-friendly error messages (#68)
- FastAPI validation error array parsing in CLI output
--bearer-tokenhelp text clarified
- Magic link auto-login: click the link in email instead of typing OTP — CLI detects it automatically (#65)
agents deletenow accepts agent addresses (agent://org/ws/name) in addition tosa_id(#63)
- Built-in agent SSE polling:
wait_seconds5→2, init sync 3s→1s — ~5s faster per workflow step (#64) - Agent provisioning: local key cache skip + parallel provisioning — step 2 from ~10s to <1s on repeat runs (#66)
org receive-policycommands:get,set,add,removefor managing org-level receive policy (cross-org intent delivery) (#60)agents receive-overridecommands:get,set,add,removefor per-agent receive policy exceptions (#60)- Updated README with full agent command reference and receive policy docs (#61)
agents policycommands:get,set,add,removefor managing agent send policies (#57)examples runauto-provisions agent service accounts — no manual setup needed (#56)
intents listnow usesGET /v1/intents(x-api-key scoped) instead ofGET /v1/inbox(bearer-only) — fixes timeout in CI and non-login environments (#58)
- Environment variable override (
AXME_BASE_URL,AXME_API_KEY) now correctly applies in fresh contexts when a saved context already has a non-localhost base URL axme examples runnow picks agent keys matching the active environment (base_url) — staging and prod keys no longer conflict when both exist inscenario-agents.json
- Command reference updated: Human Tasks and Scenarios sections added
- Type-aware task hints —
axme intents getshows contextual next-step commands based on task type (approval, review, form, etc.) - Shortcut commands:
axme intents confirm,axme intents complete,axme intents assignfor common human task outcomes
- Environment variable override (
AXME_BASE_URL,AXME_API_KEY) now works even when a saved context exists with a non-localhost base URL
- README updated: replaced alpha access section with Quick Start reference
- SA credential cache scoped by
base_url— staging and prod credentials no longer conflict
v0.2.3 — 2026-03-10
- Command aliases for common subcommands
- Double-refresh bug when token was close to expiry
- Improved update hint messaging
- Diagrams now use raw GitHub URLs from axme-docs (no proxy)
- README updated for Track H (passwordless login, workspace members, update command)
v0.2.2 — 2026-03-09
- Proactive pre-expiry token refresh — JWT is refreshed automatically before it expires, eliminating mid-command 401 errors
jwtSecondsUntilExpiryutility for token lifetime inspectionaxme workspace membersnamespace — list, include, and exclude members at workspace level- Post-login workspace prompt — CLI prompts for workspace selection after successful login
v0.2.1 — 2026-03-09
- Replaced misleading keyring warning with accurate server-side error message when credential storage falls back to file
v0.2.0 — 2026-03-09
- Email-first OTP login as the default
axme loginflow (no browser, no API key copy) - Account-session login, workspace commands, and secure secret storage (Track H Slice 1)
- Background update check +
axme updatecommand - Auto-refresh JWT on 401
invalid_actor_tokenwith persisted rotated tokens
- Release installer compatibility with GitHub release assets
axme quota showreadsbody.overview.quota_policycorrectly; removed stale email hint- Session revoke now produces human-readable output
axme workspace usehuman-readable output, logout cleanup, JWT auto-refresh- Doctor output cleaned up; removed server detail leakage
- CLI UX audit — readable output, keyring auto-fallback, silent error handling
v0.1.0 — 2026-03-08
- Initial public alpha release
- Go-first CLI surface:
axme intents,axme context,axme status,axme doctor,axme version axme loginas the alpha onboarding entry point (email OTP + browser device flow)- Service-account lifecycle commands (
axme service-accounts create/list/keys) - Actor-token auth flow (
--actor-tokenflag) - Admin command group for platform operators
- Release installer (
install.sh) for Linux and macOS - README with diagrams, command reference, and quick-start guide