Charles Wiltgen
8a7086351a
The third and last capability the ledger recorded as downgraded, replaced by a static preamble in each agent file. Cursor's subagentStart response accepts additional_context and its query carries subagent_type, which is the only field the canonical hook reads, so the port is a field rename. This is additive, not a replacement. The generated preamble carries an agent's own declared skills; the hook carries the general skill-awareness text gated by agent type. Both now ship. Verified as far as a free Cursor plan allows: the hook registers, fires, and delivers a payload carrying subagent_type, task, and subagent_model — confirmed against a live Cursor 3.17.8 delegation, which fires subagentStart three times before refusing to start the subagent with "Named models unavailable. Free plans can only use Auto." What a free plan cannot show is whether the returned context reaches a subagent that never starts. The docs and the submission matrix say so rather than implying full verification. If delivery does not work, the preamble still carries the declared skills, so the failure mode is the status quo rather than a regression. The context guard needed widening: skill awareness is legitimately multi-paragraph, where the router and crash hints are single-line. Newline and tab are now permitted, every other control character is still rejected, and the bound is separate at 8 KiB.
Axiom for Cursor
A native Cursor plugin for modern Apple platform development, generated from Axiom 27.0.0-beta.48.
Included
- 27 skill routers
- 42 agents
- 17
/axiom-*commands - Advisory session, shell, and post-write hooks
- Automatic plugin-root MCP discovery
- 30 generated mirrors intentionally excluded
Requirements and Support
The supported target is Cursor IDE/Desktop on macOS. Node.js 18 or newer is required for the MCP server, and Python 3 is required for the advisory hook adapters. This plugin makes no Cursor Cloud support claim.
The generated plugin tree contains source and static assets but no compiled or executable binary payloads. Its root mcp.json launches the separately distributed axiom-mcp npm package with npx -y axiom-mcp; first use may require network access, package resolution, and Cursor approval.
Install a Local Checkout
Clone Axiom to a stable absolute path and check out the revision you intend to test.
- Open Cursor's Customize panel and choose Add → From Local Repo.
- Select the Axiom repository root—the directory containing
.cursor-plugin/marketplace.json—and choose Add Plugins. - Under Axiom Cursor Marketplace, choose Add for Axiom.
Cursor imports the local marketplace into its plugin cache; it does not follow later checkout changes automatically. After changing revisions or regenerating axiom-cursor/, uninstall Axiom, remove Axiom Cursor Marketplace, and repeat the local-repository flow before testing.
Open Cursor's Customize panel and verify Axiom's version plus all 27 skills, 42 agents, 17 commands, hooks, and MCP server before relying on the installation.
Authority and Hooks
The released profile has 30 read-only/background agents and 12 writable/foreground agents. Cursor agents inherit host tool and MCP access that may be broader than their canonical Axiom tool lists. Review the agent, tool approvals, and MCP allowlist before running it; prompt instructions and hooks are not security boundaries. Writable agents run in the foreground and may change the shared checkout.
Hooks add routing or diagnostic context after supported events. They are advisory, fail open, and do not enforce permissions or undo an edit that already happened.
Troubleshooting and Support
If components are missing, confirm you selected the Axiom repository root, .cursor-plugin/marketplace.json points to ./axiom-cursor, and the installed local marketplace was refreshed after the checkout changed. If hooks are absent, confirm python3 is available. If MCP fails, confirm Node.js 18+ and review Cursor's MCP approval, allowlist/blocklist, and network state. Do not add a duplicate .cursor/mcp.json entry when using the plugin.
See the Cursor install and support guide or open an upstream Axiom issue with sanitized diagnostics. Cursor Marketplace acceptance, non-macOS behavior, Cloud Agents, npm availability, Xcode/toolchain failures, and third-party MCP policy are outside the documented Axiom plugin support boundary.
This directory is generated. Edit the canonical Axiom source or scripts/cursor/render.ts, then run npm run build:cursor; do not edit generated files directly.