Skip to content

2.24.0

Latest
Latest

Choose a tag to compare

View all tags
@dha-aa dha-aa released this 23 Oct 07:00
v2.24.0
a7583b1
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Added

  • The installers (scripts/install.sh, scripts/install.ps1) register ae-motion with Claude Desktop and Claude Code themselves (scripts/register.ts), so there is no command left to copy. Claude Desktop gets an absolute node path (it starts with a minimal PATH that misses Homebrew and nvm); Claude Code gets the server at user scope, so it works in every project instead of only the folder the old printed command was run in. Other servers, app settings and an env you added are kept; an entry that is already right is left alone (the panel's Update button re-runs the installer); a config file that isn't valid JSON is never overwritten. AE_MCP_REGISTER=0 skips it.

  • Install with an agent: paste "Install the After Effects MCP server from https://github.com/dha-aa/ae-motion. Follow its INSTALL.md." into Claude Code (or any agent that can run commands) and it clones, installs and registers the server, then lists the two After Effects settings only you can change. INSTALL.md holds the agent's steps; the README's Installation section offers both ways.

  • The installers stop at once with a clear message when Node.js is missing or older than 22.18, instead of failing partway through the build.

  • node scripts/check.ts --ae says what is still missing after an install: it checks the server starts, reads Allow Scripts to Write Files and Access Network from After Effects' own prefs file (read only) and asks the panel for the project, and names the step for each part that fails. The installers run the server part after building, so a build that does not start fails the install instead of the first tool call. INSTALL.md ends with it instead of looking for bridge.json, which a crashed After Effects can leave behind.

  • Install with an agent installs a missing Node.js or git for you, after asking: Homebrew, or Apple's own installers, on macOS, and winget on Windows. It checks After Effects is installed too. The README's Requirements say how to check and install each one by hand.

  • AGENTS.md points AI agents other than Claude Code (Codex, Cursor and others) to INSTALL.md for installing and to CLAUDE.md and CONTRIBUTING.md for changes. CONTRIBUTING.md now says which doc gets what (README for people, INSTALL.md for agents, docs/setup.md for everything else), and a test keeps the docs' links and sections working and every setting documented.

Fixed

  • AE_MCP_FFMPEG (where ffmpeg is, for render checks and deliver) and AE_MCP_UPDATE_URL were read by the server but not documented; both are in the Configuration table now.
  • Installing by following INSTALL.md or the README put you on main, and the panel's Update button, which installs the newest release, then moved you back to that older release (dropping changes not released yet, such as the Claude Desktop / Claude Code registration). Both now install with node scripts/update.ts, which checks out the newest release and runs the installer for your OS, so installing and updating agree.
  • The installer's Claude Code: line and INSTALL.md say how to load the server in a running Claude Code session (/mcp, ae-motion, Reconnect) instead of only "start a new session".

Changed

  • The After Effects quirks (about 40 behaviours found in live testing) are in one place, host/CLAUDE.md, instead of two lists that had drifted apart: CLAUDE.md and docs/development.md each held facts the other lacked. Claude Code now loads them only when working in host/, so the CLAUDE.md read at the start of every session is about a third smaller (26 KB to 17 KB).
  • The README is rewritten in plain words for people who just want to use ae-motion: what it does, how it works, what you need, how to install it with Claude or by hand, and the two steps in After Effects. The details (what the installer changes, other MCP clients, configuration, security, troubleshooting, updating and uninstalling) moved, unchanged, to docs/setup.md; the tool list and example prompts are in docs/tools.md.
  • The server instructions are rewritten to fit in the 4,096 characters Claude Code shows (5,599 before, 4,083 now). The last rules (editing footage, framing, text over video, sound, counting, before finishing, run_jsx) used to be cut off, so Claude only saw them after the motion-guide prompt was run; now every rule reaches the model in every session. Same rules and numbers in fewer words; about 380 tokens less per session, and Claude Code's motion-guide is about 570 tokens (was about 1,090) since nothing is left over for it. A test fails if the instructions grow past the cut.
  • The README ends with every tool, grouped by area with an example of what to ask for, and how to contribute (bug reports, CONTRIBUTING.md, AGENTS.md). A test keeps the tool table equal to the tools the server offers.
Assets 2
Loading