Connect your AI.
Connect Claude Desktop, Codex, Claude Code, Cursor, Grok or OpenCode to After Effects through Altar Bridge, read the status dot, and fix a connection that stops working.
Altar Bridge is how your AI app works in After Effects. It is an MCP server that comes with Altar. Your AI app asks it to read a comp or make a change, and Altar runs that change in After Effects, inside the normal undo history.
The Bridge runs on your Mac while After Effects is open with Altar. You don’t need an API key: your AI app does the thinking, on the plan you already have. Altar Bridge is macOS only for now.
Connect your app
- Open Altar and a composition
Open the Altar panel from Window → Extensions → Altar, then open the composition you want to work on.
- Open AI settings
Click the orange dot beside Altar in the bar at the bottom right of the panel. It opens Settings > AI apps. You can also click Altar and choose Connect your AI.
- Switch your app on
Connections lists the AI apps Altar finds on this Mac: Claude Desktop, Codex, Claude Code, Cursor, Grok and OpenCode. Apps it can’t find are listed under Not on this Mac; click one to download it.
Turn on the switch next to your app. Claude Desktop has an Install button instead.
- Claude Desktop. Press Install. Claude opens and offers to install the Altar extension. Click Install in Claude too.
- Codex and Cursor. Altar adds itself to the app, installs Altar’s skills and opens the app.
- Claude Code, Grok and OpenCode. Altar adds itself and installs Altar’s skills. Start a session in your terminal.
Use Codex for ChatGPT: Altar Bridge connects to the ChatGPT desktop app and to Codex, not to chatgpt.com in a browser.
- Send the check message
Switching an app on, or pressing Install, copies your first request for you:
Use Altar to describe my active composition and suggest one improvement. Do not change anything yet.
Start a new conversation or session in your app so it loads Altar, paste the request, and allow it when the app asks to use Altar. The app’s dot in Connections turns green once the request arrives.
If the request was not copied, click the app’s row and press Copy first request.
Using another MCP app, such as VS Code? Follow Connect any MCP app. Per-app guides for Claude Desktop, Claude Code and ChatGPT and Codex have prompts to try next.
What the status dot means
A dot sits beside Altar in the bar at the bottom right of the panel. Hover it to read the state, or click it for details and the next step. Each state has its own shape, so you don’t have to tell the colours apart.
- Green, filled: connected. An AI app is using Altar now: it sent a request or checked in during the last 45 seconds or so.
- Grey, outlined: Waiting for your AI. An AI app is set up, but none is using Altar right now.
- Orange, with a plus: Connect your AI. No AI app has been set up yet. Clicking it opens Settings > AI apps.
- Red, crossed out: The Altar Bridge is not running. Your AI app can’t reach After Effects.
- Red, with an exclamation mark: After Effects is stuck. A request timed out, and Altar holds the rest until you reset.
While the panel loads, the dot is a grey dashed circle that reads Checking the Altar Bridge…, so a slow start never flashes red.
Green: connected
Nothing to fix. Click the dot to see which app is connected and when it last sent a request. AI settings opens Settings > AI apps.
If the dot says the last command failed, it names the reason. A reason of
UPDATE_ALTAR or UNSUPPORTED_OPERATION means your AI app’s connection is
newer than the Altar in After Effects: update Altar, restart After Effects,
then try again. For other reasons, see
Altar Bridge troubleshooting.
If your app answers without using Altar, ask it to use Altar by name, for example “Use Altar to read my active comp.”
Grey: waiting for your AI
Cause. Your app is set up, but it isn’t open, or it hasn’t loaded Altar yet. Green turns grey about 45 seconds after your app’s last request, so grey after you close the app is normal.
Fix. Open your app and start a new conversation or session: most apps only load new connections there. Click the dot, press Copy check message and paste it into your app.
- Claude Desktop. If its row in Settings > AI apps says Turned off in Claude Desktop, turn Altar on in Claude’s Settings > Extensions.
- Grok, OpenCode and Codex. If the row says Turned off, turn its switch on again.
- Codex and Claude Code. After you update Altar, restart the app so it picks up the new tools.
Orange: connect your AI
Cause. No AI app has been set up yet.
Fix. Click the dot, then follow Connect your app. Each row has a dot of its own: green when the app used Altar this session, grey when it is on but hasn’t yet, orange when it needs you. Click a row to read its details. If something gets in the way:
- “No AI app found on this Mac.” Click an app under Not on this Mac, install it, open it once, then come back to Settings > AI apps.
- “Could not read the app’s settings.” Altar couldn’t read them in time. Click the row again.
- “Altar’s entry has different settings.” Your app already has a server
called
altar, often from an older install. Turn the switch off, then on, to replace it. For Claude Desktop, remove Altar in Claude’s Settings > Extensions, then press Install. - “Claude did not open the Altar installer.” Press Show installer in Finder and double-click the file.
- “This Altar install is missing its AI connection.” Reinstall Altar from the download page, restart After Effects and connect again.
- “Connecting your AI app requires Altar in After Effects on macOS.” Altar Bridge is macOS only for now.
Red: Bridge not running or After Effects stuck
Red has two causes, and the dot shows which one.
The Altar Bridge is not running. After Effects is closed, or Altar’s connection stopped. Your AI app says “Altar Bridge is not running.”
Fix. Keep After Effects open with Altar installed. Click the dot and press Reconnect. If it stays down, quit and reopen After Effects, then ask again.
After Effects is stuck. A request took too long, and After Effects may still be working on it, for example during a render or behind an open dialog. Altar holds every request until you say it is safe, and shows a red banner: “After Effects is stuck.”
Fix. Finish what After Effects is doing and check that it responds. Then press Reset in the red banner or in the dot’s details. Look at the comp before you ask again: the change may already have landed.
Remove Altar from an app
Removing Altar from your AI app doesn’t uninstall Altar or touch your projects.
- Codex, Claude Code, Cursor, Grok and OpenCode. Turn the app’s switch off in Settings > AI apps.
- Claude Desktop. Open Claude’s Settings > Extensions and remove Altar.
- Any other MCP app. Delete the
altarentry from its MCP config, then restart the app.
Altar’s skills (altar and improve-altar) stay in folders of their own. To
remove them, delete both from ~/.agents/skills (Codex, Cursor and OpenCode),
~/.claude/skills (Claude Code) or ~/.grok/skills (Grok).