docs: editor release research for July 2026

docs/editor-research/claude-code/2.1.215.md

@@ -0,0 +1,71 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "claude-code"
+editor_version: "2.1.215"
+sources:
+   - "https://code.claude.com/docs/en/changelog"
+   - "https://www.npmjs.com/package/@anthropic-ai/claude-code"
+---
+
+## Changes affecting aix
+
+- Claude Code 2.1.214 changed hook `if:` glob semantics: a single-segment `dir/**`
+  condition now matches only `<cwd>/dir`, and `**/dir/**` is required for any-depth
+  matching.
+   - aix status: addressed 2026-07-19. aix passes the `if` field through unchanged
+     (`packages/core/src/editors/strategies/claude-code/hooks.ts`); the new matching
+     semantics are now documented in the Claude Code hooks notes in
+     `packages/schema/src/editor-support.ts`, which feeds the support matrix docs.
+- Claude Code 2.1.214 made `SessionStart` hooks report `source: "fork"` when a session
+  begins as a fork, and 2.1.198 added `Notification` hook payloads
+  `agent_needs_input` / `agent_completed` for background agents.
+   - aix status: no config schema change needed. aix writes hook definitions, not
+     runtime payload schemas, and `SessionStart` / `Notification` are already valid
+     event names in the supported list.
+- Claude Code 2.1.178 added nested `.claude/skills/` discovery (with `<dir>:<name>`
+  disambiguation) and closest-wins resolution for nested `.claude/` agents, workflows,
+  and output styles; 2.1.211 and 2.1.195 fixed nested `.claude/rules/*.md` loading.
+   - aix status: no implementation change needed. aix writes top-level `.claude/`
+     directories, which remain valid; nested discovery is additive editor behavior.
+- Claude Code 2.1.178 added `Tool(param:value)` permission-rule syntax and 2.1.200
+  renamed the "default" permission mode to "manual" (`"defaultMode": "manual"`).
+   - aix status: no implementation change needed today. aix does not generate Claude
+     Code permission rules or `defaultMode`. Re-check if aix adds a portable
+     permissions feature.
+- Claude Code 2.1.196 stopped `claude mcp list` / `get` from spawning `.mcp.json`
+  servers that were self-approved via a committed `.claude/settings.json`.
+   - aix status: no format change needed. aix `.mcp.json` output is unchanged; users
+     may see extra approval steps at runtime.
+- Claude Code 2.1.169 added `--safe-mode` / `CLAUDE_CODE_SAFE_MODE` (disables all
+  customizations) and `disableBundledSkills`.
+   - aix status: no config change needed, but safe mode disables aix-written rules,
+     prompts, skills, agents, and hooks at runtime. Worth a docs note if users report
+     aix output "not loading".
+- Claude Code 2.1.207 stopped reading plugin option values from project-level
+  `.claude/settings.json` and rejected `${user_config.*}` in shell-form plugin hook
+  commands.
+   - aix status: no implementation change needed. aix does not generate Claude Code
+     plugin manifests or plugin options; aix-managed hooks in `.claude/settings.json`
+     are not plugin hooks.
+- Claude Code 2.1.172 / 2.1.198 changed subagent execution: subagents run in the
+  background by default, can nest up to 5 levels, and are capped per session
+  (`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`).
+   - aix status: no config schema change needed. aix agent frontmatter
+     (`description`, `mode`, `model`, `tools`, `permissions`, `mcp`) is unchanged by
+     these runtime behaviors.
+- Claude Code 2.1.166–2.1.215 added many new settings keys (`axScreenReader`,
+  `vimInsertModeRemaps`, `sandbox.credentials`, `autoMode.classifyAllShell`,
+  `language`, `attribution.sessionUrl`, `enforceAvailableModels`, and others).
+   - aix status: no implementation change needed, but aix's section-managed writes to
+     `.claude/settings.json` must keep preserving unknown keys. Existing merge behavior
+     should be covered by tests before any hooks change.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/claude-code/hooks.ts` owns Claude Code hook
+  output, including the `if` passthrough field.
+- `packages/core/src/editors/strategies/claude-code/mcp.ts` owns Claude Code MCP output.
+- `packages/core/src/editors/adapters/claude-code.ts` wires rules, prompts, MCP, skills,
+  agents, and hooks for Claude Code.
+- `packages/schema/src/editor-support.ts` lists the supported Claude Code hook events,
+  including `SessionStart` and `Notification`.

docs/editor-research/codex/0.144.6.md

@@ -0,0 +1,68 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "codex"
+editor_version: "0.144.6"
+sources:
+   - "https://learn.chatgpt.com/docs/changelog"
+   - "https://github.com/openai/codex/releases"
+   - "https://www.npmjs.com/package/@openai/codex"
+   - "https://releasebot.io/updates/openai/codex"
+---
+
+## Changes affecting aix
+
+- The official Codex changelog moved: `https://developers.openai.com/codex/changelog`
+  now returns a 308 redirect to `https://learn.chatgpt.com/docs/changelog`.
+   - aix status: addressed 2026-07-19. The
+     `examples/custom/skills/editor-release-research/SKILL.md` source hints now list
+     `https://learn.chatgpt.com/docs/changelog`. No generated editor config is
+     affected.
+- Codex 0.144.0 added a `writes` app-approval mode (declared read-only actions run
+  without prompting; writes still prompt).
+   - aix status: no implementation change needed. aix does not write Codex approval
+     or permission config. Re-check if aix adds a portable permissions feature.
+- Codex 0.144.0 let MCP tools request interactive authentication without an
+  experimental opt-in, and 0.142.2/0.143.0 turned on MCP tool search by default.
+   - aix status: no config shape change needed. `~/.codex/config.toml` MCP entries that
+     aix writes are unchanged; these are runtime behaviors.
+- Codex 0.140.0 made disabled MCP servers persist across runtime overlays, resolved MCP
+  server registrations through a catalog system, and added encrypted local storage for
+  CLI and MCP OAuth credentials.
+   - aix status: no implementation change needed. aix writes server definitions, not
+     enable/disable state or credentials.
+- Codex 0.140.0 decoupled the skills extension from core and improved parallel skill
+  metadata reads (0.142.0); 0.142.0 also improved plugin loading across "multiple skill
+  paths".
+   - aix status: no path change identified. aix-managed skills at
+     `.agents/skills/{name}/` and `~/.codex/skills/{name}/` remain the documented
+     surfaces. Re-verify skill paths in the Codex docs if a future release note names
+     new locations.
+- Codex 0.142.0 extended remote environments to support executor-native `AGENTS.md`
+  discovery, and 0.140.0 made AGENTS.md loadable "from all bound environments".
+   - aix status: no implementation change needed. aix writes root and directory-level
+     AGENTS.md files, which remain the native rule surface.
+- Codex 0.143.0 enabled remote plugins by default with npm marketplace sources.
+   - aix status: no implementation change needed. aix does not manage Codex plugins.
+- Detailed official release notes for 0.136.0–0.141.0 are no longer exposed on the
+  changelog page or the visible GitHub releases pages. Externally sourced summaries
+  (releasebot.io, havoptic.com) describe 0.136 (archived sessions), 0.137 (TUI and
+  enterprise credit limits), 0.138 (Codex Desktop handoff), and 0.139 (code-mode web
+  search) with no config-surface changes.
+   - aix status: no implementation change identified for 0.136–0.141. These facts are
+     externally sourced; re-verify against official docs if any related bug reports
+     arrive.
+- No hook-related changes were found for 0.136.0–0.144.6.
+   - aix status: no change to `.codex/hooks.json` output. The supported event list
+     (`PermissionRequest`, `PostToolUse`, `PreToolUse`, `SessionStart`, `Stop`,
+     `UserPromptSubmit`) remains current.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/codex/rules.ts` writes Codex AGENTS.md content.
+- `packages/core/src/editors/strategies/codex/mcp.ts` writes global
+  `~/.codex/config.toml` MCP config.
+- `packages/core/src/editors/strategies/codex/prompts.ts` converts prompts into skills.
+- `packages/core/src/editors/strategies/codex/hooks.ts` maps supported aix hook events
+  into Codex `hooks.json`.
+- `packages/schema/src/editor-support.ts` documents Codex support, including the
+  global-only MCP note and the prompt-to-skill shim.

docs/editor-research/copilot/1.0.71.md

@@ -0,0 +1,57 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "copilot"
+editor_version: "1.0.71"
+sources:
+   - "https://raw.githubusercontent.com/github/copilot-cli/main/changelog.md"
+   - "https://www.npmjs.com/package/@github/copilot"
+---
+
+## Changes affecting aix
+
+- Copilot CLI 1.0.61 auto-loads MCP servers from the `.github/mcp.json` workspace
+  config file.
+   - aix status: verified 2026-07-19, no change needed. The Copilot CLI config-dir
+     reference documents both `.mcp.json` and `.github/mcp.json` as project-level MCP
+     files with equal standing ("Project-level MCP configurations (in `.mcp.json` or
+     `.github/mcp.json`) take precedence over user-level definitions"). aix keeps
+     writing `.mcp.json` (shared with Claude Code) and imports either path; the
+     support-matrix note was updated to say so.
+- Copilot CLI 1.0.63 rejects custom-agent names that would create hidden files.
+   - aix status: verified 2026-07-19, guard already present. `sanitizeFileName` in
+     `packages/core/src/editors/adapters/base.ts` converts non-alphanumerics to dashes
+     and strips leading dashes, so a leading-dot filename cannot be emitted; a
+     regression test was added in
+     `packages/core/src/__tests__/editors/adapters.test.ts`.
+- Copilot CLI 1.0.66 lets skills with the same name from different plugins coexist, and
+  1.0.69 keeps embedded `/skill` tokens in skill prompt context.
+   - aix status: no implementation change needed. aix-managed skills under
+     `.github/skills/{name}/` and `~/.config/github-copilot/skills/{name}/` are
+     unaffected by plugin-skill namespacing.
+- Copilot CLI 1.0.67–1.0.69 preserve custom-agent tool filters in nested subagents and
+  show warnings when host custom agents fail to load.
+   - aix status: no config schema change needed. This is runtime enforcement of the
+     existing `tools` frontmatter aix already writes.
+- Copilot CLI 1.0.70 lets custom agents that request a shell tool by alias also receive
+  the matching read, list, and stop shell tools.
+   - aix status: no implementation change needed. aix passes `tools` lists through;
+     alias expansion happens in the editor.
+- Copilot CLI 1.0.70 persists GitHub MCP toolset/tool config via `settings.json`, and
+  1.0.61 added a `/settings` dialog plus a `tabs` setting.
+   - aix status: no implementation change needed. These are editor-managed settings
+     files, not surfaces aix generates.
+- Copilot CLI 1.0.62 lets plugins ship extensions via the plugin marketplace.
+   - aix status: no implementation change needed. aix does not manage Copilot plugins.
+- No hook event or hook schema changes were found in 1.0.61–1.0.71.
+   - aix status: no change to `.github/hooks/hooks.json` output or the supported event
+     list.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/copilot/hooks.ts` owns Copilot hook output.
+- `packages/core/src/editors/strategies/copilot/prompts.ts` writes project prompt files
+  and converts user-scope prompts into skills.
+- `packages/core/src/editors/adapters/copilot.ts` wires Copilot rules, prompts, MCP,
+  skills, agents, and hooks.
+- `packages/schema/src/editor-support.ts` documents the `.mcp.json` project path with
+  the `.github/mcp.json` import fallback note.

docs/editor-research/cursor/3.11.md

@@ -0,0 +1,38 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "cursor"
+editor_version: "3.11"
+sources:
+   - "https://cursor.com/changelog"
+---
+
+## Changes affecting aix
+
+- Cursor 3.9 added a Customize page that consolidates plugins, skills, MCPs, subagents,
+  rules, commands, and hooks, with user, team, or workspace-level customization.
+   - aix status: no generated config change identified. The changelog describes a
+     management UI over the existing surfaces aix writes (`.cursor/rules`,
+     `.cursor/commands`, `.cursor/agents`, `.cursor/skills`, `.cursor/mcp.json`,
+     `.cursor/hooks.json`). Re-check Cursor docs if team/workspace scopes gain
+     file-backed local config aix could target.
+- Cursor 3.10 added team MCP server configuration distributed across cloud agents, IDE,
+  and CLI through team marketplaces.
+   - aix status: no implementation change needed. Team MCP distribution is
+     cloud-managed, not a local config file. aix project and user `mcp.json` output is
+     unchanged.
+- Cursor 3.11 added side chats (`/side`, `/btw`) and conversation search; 3.9 added the
+  iOS app and marketplace leaderboard.
+   - aix status: no implementation change needed. These are editor UI features.
+- No changes to rules, commands, agents, hooks events, skills paths, or AGENTS.md
+  compatibility were found in the 3.8–3.11 changelog entries.
+   - aix status: no change needed. The Cursor hook event list and config paths in
+     `packages/schema/src/editor-support.ts` remain current as documented.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/cursor/hooks.ts` writes Cursor hooks with a
+  `version: 1` wrapper and camelCase event names.
+- `packages/core/src/editors/strategies/cursor/prompts.ts` writes `.cursor/commands/`.
+- `packages/core/src/editors/strategies/shared/standard-mcp.ts` owns Cursor MCP output.
+- `packages/core/src/editors/adapters/cursor.ts` wires Cursor native rules, commands,
+  MCP, skills, agents, and hooks.

docs/editor-research/gemini/0.51.0.md

@@ -0,0 +1,55 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "gemini"
+editor_version: "0.51.0"
+sources:
+   - "https://github.com/google-gemini/gemini-cli/releases"
+   - "https://github.com/google-gemini/gemini-cli/blob/main/docs/changelogs/index.md"
+   - "https://www.npmjs.com/package/@google/gemini-cli"
+   - "https://releasebot.io/updates/google/gemini-cli"
+---
+
+## Changes affecting aix
+
+- Gemini CLI 0.49.0 migrated the `coreTools` setting to `tools.core` in
+  `settings.json`.
+   - aix status: verified 2026-07-19, no change needed. aix does not emit `coreTools`,
+     and the existing test "preserves user-authored keys in .gemini/settings.json
+     across installs" in `packages/core/src/__tests__/editors/adapters.test.ts` covers
+     unknown-key preservation for both old and new key shapes.
+- Gemini CLI 0.49.0 added path-traversal prevention during skill install, and 0.51.0
+  fixed a "symbolic link directory escape in memory import processor".
+   - aix status: needs follow-up for verification only. aix installs Gemini skills as
+     symlinks from `.gemini/skills/{name}/` (and `.agents/skills/`) into `.aix/skills/`.
+     Verify on a current Gemini CLI that symlinked skill directories and GEMINI.md
+     imports still load under the stricter symlink handling.
+- Gemini CLI 0.47.0 shipped Antigravity transition banners and migration commands for
+  the Antigravity CLI (externally sourced from release summaries).
+   - aix status: needs follow-up as a watch item. If Gemini CLI rebrands or merges into
+     Antigravity the config directories (`.gemini/`, `~/.gemini/`) and context file
+     (`GEMINI.md`) could move, similar to the Windsurf → Devin Desktop rebrand. No path
+     change is documented yet, so no aix change now.
+- Gemini CLI 0.50.0 added tool registry discovery for automated tool detection.
+   - aix status: no config shape change identified. MCP config in
+     `.gemini/settings.json` is unchanged.
+- Gemini CLI 0.49.0 standardized tool output formatting, fixed zero-quota fail-fast
+  behavior, and pinned dependencies; 0.51.0 added caretaker service work and escape
+  sequence handling fixes.
+   - aix status: no implementation change needed. These are runtime behaviors.
+- No changes to GEMINI.md handling, TOML command files, agent frontmatter, or hook
+  event names were found for 0.46.0–0.51.0.
+   - aix status: no change needed to Gemini rules, prompts, agents, or hooks output.
+     The 0.46.0–0.48.0 release notes are thinly documented upstream (the changelog
+     index only carries announcements for select versions); re-verify if a bug report
+     points at one of those versions.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/gemini/hooks.ts` writes hooks into
+  `.gemini/settings.json` alongside MCP config.
+- `packages/core/src/editors/strategies/gemini/mcp.ts` owns Gemini MCP output.
+- `packages/core/src/editors/strategies/gemini/prompts.ts` writes TOML command files.
+- `packages/core/src/editors/adapters/gemini.ts` uses native Gemini skills under
+  `.gemini/skills/{name}/` with `.agents/skills/` compatibility.
+- `packages/schema/src/editor-support.ts` documents Gemini's current aix feature
+  support, including the shared `settings.json` merge note.

docs/editor-research/opencode/1.18.3.md

@@ -0,0 +1,49 @@
+---
+research_performed_at: "2026-07-19T11:45:00+00:00"
+editor_id: "opencode"
+editor_version: "1.18.3"
+sources:
+   - "https://github.com/anomalyco/opencode/releases"
+   - "https://opencode.ai/docs/skills/"
+   - "https://www.npmjs.com/package/opencode-ai"
+---
+
+## Changes affecting aix
+
+- OpenCode 1.18.2 stopped subagents from launching nested subagents by default and
+  added a configurable `subagent_depth` limit.
+   - aix status: no implementation change needed today. aix does not write OpenCode
+     agent-depth settings. Re-check if aix's portable agent config grows a nesting or
+     depth field that should map to `subagent_depth`.
+- The OpenCode skills docs now list a native `skill` tool plus pattern-based skill
+  permissions in `opencode.json` (`allow` / `deny` / `ask`, per-agent overrides, and
+  `skill: false` to disable).
+   - aix status: needs follow-up only if aix adds portable skill permissions. Skill
+     discovery paths are unchanged and match aix output: `.opencode/skills/`,
+     `.claude/skills/`, and `.agents/skills/` at project scope, with
+     `~/.config/opencode/skills/`, `~/.claude/skills/`, and `~/.agents/skills/` at
+     user scope.
+- OpenCode 1.17.10 introduced namespaced plugin hook APIs and a V2 plugin API.
+   - aix status: no implementation change needed. These are JavaScript plugin surfaces,
+     not the lifecycle hook config files aix models; OpenCode hooks remain
+     `unsupported` in the aix matrix.
+- OpenCode 1.17.12–1.17.14 added MCP resource template listing/read tools, a code-mode
+  MCP adapter, scoped MCP auth status per server URL, and preserved metadata in
+  paginated tool catalogs; 1.17.7 sends the current workspace as the MCP client root.
+   - aix status: no config shape change needed. `opencode.json` `mcp` entries that aix
+     writes are unchanged; these are runtime MCP behaviors.
+- OpenCode 1.18.0 completed the Desktop v2 migration; 1.17.16–1.17.19 are composer and
+  model-picker UI changes.
+   - aix status: no implementation change needed.
+- No changes to AGENTS.md handling, command files, or agent frontmatter were found in
+  1.16.1–1.18.3.
+   - aix status: no change needed to OpenCode rules, prompts, or agents output.
+
+## Baseline evidence
+
+- `packages/core/src/editors/strategies/opencode/` owns OpenCode rules, prompts, MCP,
+  and skills output.
+- `packages/core/src/editors/adapters/opencode.ts` wires OpenCode support and marks
+  hooks unsupported.
+- `packages/schema/src/editor-support.ts` documents OpenCode paths, including
+  `.opencode/skills/{name}/` and the `.agents/skills/` compatibility note.