axiom-mcp 27.5.0 → 27.6.0

package/README.md

@@ -8,7 +8,7 @@ Model Context Protocol (MCP) server for Axiom's Apple-platform development skill
 - **Agents** — fetch any agent's instructions with `axiom_get_agent`, then follow them
 - **Commands** — structured workflows as MCP Prompts
 - **Command-line tools** — `xclog`, `xcsym`, and `xcprof` as MCP Tools, for console capture, crash symbolication, and profiling (Apple Silicon Mac with Xcode)
-- **`xcproject`** — a command the package installs alongside the server, for reading `project.pbxproj` and JSON5 `project.xcproj` files; it has no MCP tool
+- **`xcproject`** — a command the package installs alongside the server, for reading `project.pbxproj` and JSON5 `project.xcproj` files; it has no MCP tool, so your assistant runs it in a shell as `npx -y -p axiom-mcp xcproject`
 - **Apple's bundled documentation** — the guides and diagnostics inside Xcode, searchable alongside the skills when Xcode is installed
 - **Two modes** — production (the bundled snapshot, the default) or development (reads a plugin checkout)
 
@@ -58,7 +58,7 @@ Add to `.mcp.json` at the root of your project, or to `~/.copilot/mcp-config.jso
 
 VS Code still reads the older `.vscode/mcp.json` (with a top-level `servers` object), but marks it deprecated.
 
-### Claude desktop app
+### Claude Desktop
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
@@ -116,6 +116,7 @@ Add to `~/.gemini/settings.json` (or `.gemini/settings.json` in a project):
 | `AXIOM_XCODE_PATH` | Path to an Xcode app | The one `xcode-select` points to | The Xcode whose bundled documentation and version the server reads |
 | `AXIOM_XCLOG_PATH`, `AXIOM_XCSYM_PATH`, `AXIOM_XCPROF_PATH` | File path | Bundled binary | Use a different `xclog`, `xcsym`, or `xcprof` binary |
 | `AXIOM_XCLOG_TIMEOUT`, `AXIOM_XCSYM_TIMEOUT`, `AXIOM_XCPROF_TIMEOUT` | Seconds | `120`, `120`, `300` | Time limit for each call to that tool; raise it for long recordings |
+| `AXIOM_FULL_READ_LIMIT` | Characters | `20000` | Size above which `axiom_read_skill` returns a skill's section list instead of its full text, unless the call names sections or passes `full: true`, or the skill has one section |
 
 ### Modes
 
@@ -203,6 +204,8 @@ A router's id is its name; a specialized skill's id is its router's name, two hy
 
 The `xclog`, `xcsym`, and `xcprof` tools run macOS arm64 binaries shipped inside the package (`dist/bin/`). **They need an Apple Silicon Mac with Xcode installed**; on other platforms they return an explanatory message instead of running.
 
+Two of Axiom's tools aren't in this package. Without `axbuild`, your assistant saves build and test output to a log file and reads it. Without `xcui`, it can still send simulator input through AXe if you've installed it, but has no equivalent for `xcui`'s waits, assertions, accessibility settings, system dialogs, VoiceOver checks or resize sweeps.
+
 **`axiom_xcprof_record` keeps its higher-risk modes gated.** It attaches to a process by default and always runs non-interactively. Launching a process (`launch`) requires `allowLaunch: true`, and system-wide capture (`allProcesses`) requires `allowAllProcesses: true`; without those flags the binary refuses. Recordings are always duration-bounded.
 
 ## Development

package/dist/bundle-stats.json

@@ -1,19 +1,19 @@
 {
-  "totalBytes": 14137900,
+  "totalBytes": 14163652,
   "skills": {
-    "count": 307,
-    "bytes": 7734549
+    "count": 312,
+    "bytes": 7783548
   },
   "commands": {
     "count": 17,
-    "bytes": 52529
+    "bytes": 54398
   },
   "agents": {
     "count": 42,
-    "bytes": 719454
+    "bytes": 726054
   },
   "searchIndex": {
-    "bytes": 5631368
+    "bytes": 5599652
   },
-  "generatedAt": "2026-10-13T22:29:11.558Z"
+  "generatedAt": "2026-10-18T22:59:08.385Z"
 }