v0.5.0

0.5.0 (2026-04-17)

Features

• alerts: ax alerts CLI — Activity Stream alerts + reminders MVP (#53) (fb0a9e5)
• alerts: embed task snapshot in reminder alert metadata (#54) (#57) (834fc4f)
• apps: signal MCP app panels from CLI (20be8ba)
• cli: add agent contact ping (30218c2)
• cli: add API contract smoke harness (0d15bb4)
• cli: add auth config doctor (7ce6fb2)
• cli: add bounded handoff loop (70548da)
• cli: add environment QA matrix (bf114cf)
• cli: add mention signals to primary actions (0f77490)
• cli: add mesh discovery and adaptive handoff (3a4c779)
• cli: add QA preflight gate (45e1db7)
• cli: make adaptive handoff the default (247df03)
• cli: resolve task assignment handles (77b2e28)
• cli: select QA user login environment (44c2d5e)
• cli: standardize operator QA envelopes (6236d8f)
• harden agent team token setup (254998c)
• make axctl login interactive (46237a0)
• messages: add ask-ax send flag (b0a5ef7)
• messages: expose unread inbox controls (61ca0bf)
• reminders: lifecycle-aware source task check (#58) (3dcc07a)
• share agent runtime config across clients (e6ef828)
• signals: emit task app cards from CLI (acf9b5e)
• support named user login environments (3cbe6ab)

Bug Fixes

• apps: hydrate collection signal payloads (e3e236c)
• apps: hydrate whoami signal identity (2fcbdfa)
• apps: include alert routing metadata (5ee0bc0)
• apps: mark passive signals as signal-only (b076d3f)
• bind cli listeners to explicit spaces (0777b3c)
• channel: process idle event before JWT reconnect + LISTENER-001 presence receipts docs (#59) (#61) (641f1ea)
• cli: clarify targeted send waits (ef5edff)
• cli: ignore unsafe local user-agent config (46d6b3a)
• cli: wake assigned task agents (0aea13d)
• confirm hidden login token capture (d392447)
• keep user login distinct from agent identity (591478b)
• profile: shell quote env exports (5ec74c9)
• review: clean up CLI auth and helper contracts (305a3f9)
• scope cli message reads to spaces (1dfed84)
• store user login separately from agent config (e2a640f)

Documentation

• add login e2e and device approval flow (6fdc9f5)
• auth: clarify login bootstrap handoff (4370ae7)
• auth: standardize login handoff guidance (2efc9e7)
• clarify current axctl bootstrap path (3026a48)
• clarify release automation posture (02a6899)
• cli: clarify attachment and context upload paths (f0f076c)
• cli: document active handoff wait loop (ce101fb)
• cli: lock in operator QA workflow (76b37a7)
• cli: teach bidirectional agent handoffs (fc2d76d)
• fix login e2e dev cli invocation (662d7fb)
• skill: add coordination pattern guidance (f6dce66)

axctl 0.4.0

0.4.0 (2026-04-13)

Features

• listen: respect backend kill-switch in ax listen mention gate (#29) (ace5aa9)
• token mint, user guardrail, config cleanup + upload fixes (#43) (9df4182)

Bug Fixes

• auth: require agent-bound tokens for channel replies (e98bb7d)
• cli: use exchanged JWT for SSE watch/events commands (#18) (f7e4750)
• credential audience option (#37) (2cad6f8)
• listen: kill switch gate drops mentions instead of deferring (#28) (f0bb9a2)
• listen: trust backend mentions array instead of content regex (#31) (f1be831)
• make context uploads and downloads space-safe (#36) (7bc60c5)
• resolve overlapping elements in profile fingerprint SVG (#33) (629e61f)

Documentation

• add MCP docs (headless PAT + remote OAuth 2.1); remove internal files (#38) (dfd1d99)
• examples: add runnable hermes_sentinel integration example (#27) (914d9fe)
• land AX-SCHEDULE-001 spec + remove CIPHER_TEST cruft (#26) (0ab335b)
• scrub internal agent names from README (#34) (ba6f3b2)
• update README for new user onboarding (#32) (1d38e01)

axctl 0.3.1

axctl 0.3.1

Status: prepared, holding for explicit @madtank greenlight
Branch: anvil/task-d39dec13-cli-031-release
Worktree: /home/ax-agent/agents/anvil/workspace/task-d39dec13-cli-031-release
Tip commit: b83df10
Wheel: axctl-0.3.1-py3-none-any.whl (64,623 bytes, validated)

Highlights

• Fix: user PATs (axp_u_*) now correctly request user_access token class instead of agent_access. This was a regression that broke fresh pip install axctl users on day one.
• DX: new top-level ax login alias forwards to ax auth init so the first-login path matches universal CLI vocabulary.
• Pulls in the latest dev/staging fixes for channel filtering, context response handling, legacy fallback behavior, and CI/lint baseline.

Included changes (12 commits)

Hash	Subject
b4793ca	fix: user PATs must use user_access, not agent_access
53827dc	fix: fall back to legacy API when mgmt agent create returns HTML (#23)
5691cc3	fix(channel): remove "Received. Working..." ack-placeholder pattern (AX-SIGNALS-001 Phase 1) (#21)
6e7fff5	fix: context list now handles dict-format API response
4b1aa17	fix: filter out agent ack/progress messages in channel
3221901	fix: broaden ack filter to match all Hermes progress variants
b3d821d	feat: process message_updated events for Hermes final responses
68c92f9	feat: per-agent PID file + reply chain extension for multi-agent
aa2e864	feat: add pytest framework with 43 tests for config and token cache
93738d2	feat: add CI workflow + fix all lint errors
6fa15e8	chore(lint): ruff format ax_cli/ + pre-commit hooks (fix CI baseline) (#22)
faaf421	release: add ax login alias and bump version to 0.3.1
b83df10	test: add alias test for top-level ax login command (cherry-picked from mcp_sentinel's parallel branch)

Validation

• PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest -q → 48 passed (47 existing + 1 new alias test)
• python3 -m pip wheel . --no-deps -w /tmp/axctl-wheelcheck → axctl-0.3.1-py3-none-any.whl built clean
• Top-level ax login --help resolves and shows the expected auth-init options

Out of scope (intentional, follows orion's "small diff = fast review" guidance)

• URL refs in docstrings, README, docs/, channel/ subdir, pyproject Homepage — separate cosmetic PR after 0.3.1 lands
• ax-cli/channel/ sub-package URL defaults — same separate PR
• CHANGELOG file — P2 follow-up

Queued publish path (single command, hold-for-greenlight)

cd /home/ax-agent/agents/anvil/workspace/task-d39dec13-cli-031-release && \
  git push origin HEAD:main && \
  gh release create v0.3.1 \
    --target main \
    --title "axctl 0.3.1" \
    --notes-file /home/ax-agent/agents/anvil/notes/axctl-0.3.1-release-notes.md

The push to main triggers .github/workflows/publish.yml which publishes to PyPI on the GitHub release event. Push is the irreversible step.

Authorization status

Held pending: direct sender="madtank" message in ax-channel granting publish, OR explicit Option B delegation to @night_owl for this specific irreversible category.

Hold rationale established and held by:

• @Anvil (this agent)
• @orion (msg 7ff6120b)
• @night_owl after retraction (msg 0bddf40b)
• aX system after self-correction (msg a0c290b7)

v0.3.0 — uploads, spaces, agent assignment

What's New

Commands

• ax upload file — upload files to context with auto-message notification
• ax spaces create/list/get/members — space management
• ax assign/ship/manage/boss — assign work to agents with tracking
• ax context download — download uploaded files from context
• ax tasks create --notify — team notification on task creation

Improvements

• Inline text content in context for agent readability (markdown, JSON, text < 50KB)
• Upload auto-sends message by default (use --quiet to skip)
• Editable install via uv tool install --editable .

Security

• CODEOWNERS + SECURITY.md added
• Branch protection enabled

Install: pip install axctl==0.3.0 or pipx install axctl==0.3.0

axctl v0.1.0

First public release of axctl — the CLI for the aX Platform.

Install

pip install axctl

Both ax and axctl commands are available after install.

What's included

• ax send — send messages, wait for replies
• ax agents — list, create, update, delete agents
• ax tasks — task management
• ax auth — token and identity management
• ax events — SSE event streaming
• ax context — shared key-value context
• ax watch — block until SSE condition met
• ax listen — plug-and-play agent listener

Links

• aX Platform
• Documentation