Altar is in closed beta
Altar
Join the beta
Help and reference

Connect your AI.

Connect Claude Desktop, Codex or Claude Code 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

  1. Open Altar and a composition

    Open the Altar panel from Window → Extensions → Altar, then open the composition you want to work on.

  2. Open Connect your AI

    Click Altar in the bar at the bottom right of the panel and choose Connect your AI.

    The first time you open Altar, a Connect your AI card also appears on the canvas. Press Connect to open the same dialog, or Not now to hide the card. Once an app is set up, the menu item reads AI settings and opens Settings > AI apps, where you can connect another app.

  3. Pick your app

    Altar lists Claude Desktop, Codex and Claude Code, and marks the ones it finds on this Mac. If it finds only one, it picks it for you. An app Altar can’t find shows Not installed and a Get it button.

    Use Codex for ChatGPT: Altar Bridge connects to the ChatGPT desktop app and to Codex, not to chatgpt.com in a browser.

  4. Press Connect

    Press Connect with your app’s name on it.

    • Claude Desktop. Claude opens and offers to install the Altar extension. Click Install.
    • Codex and Claude Code. Altar adds itself to the app and installs two skills: altar, which tells the app how to work with Altar, and improve-altar, a retrospective you run yourself to see where Altar slowed your AI app down.
  5. Send the check message

    Connect copies your first request for you:

    your AI app

    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. Altar shows Waiting for your AI until the request arrives, then Connected. Verified just now.

    If the request was not copied, press Copy again.

Using another MCP app, such as Cursor or 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 AI. No AI app has been set up yet.
  • 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. Connect another app opens Connect your AI again.

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 Connect your AI shows Turned off, turn Altar on in Claude’s Settings > Extensions, then press Check again.
  • Codex and Claude Code. After you update Altar, restart the app so it picks up the new tools.

Orange: connect AI

Cause. No AI app has been set up yet.

Fix. Click the dot and press Connect AI, or click Altar in the bar and choose Connect your AI, then follow Connect your app. If something gets in the way:

  • “No AI app found on this Mac.” Press Get Claude or Get ChatGPT, install the app, open it once, then open Connect your AI again.
  • “Could not check.” Altar couldn’t read the app’s settings in time. Press Check again.
  • Needs review. Your app already has a server called altar, often from an older install. Altar lists the settings it expects. For Codex and Claude Code it also lists two commands: run them in Terminal, then press Check again. For Claude Desktop, remove Altar in Claude’s Settings > Extensions, then connect again.
  • “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.

  • Claude Desktop. Open Claude’s Settings > Extensions and remove Altar.
  • Codex. Run codex mcp remove altar in Terminal.
  • Claude Code. Run claude mcp remove --scope user altar in Terminal.
  • Any other MCP app. Delete the altar entry from its MCP config, then restart the app.

Codex and Claude Code also keep Altar’s skills in folders of their own. To remove them, delete altar and improve-altar from ~/.agents/skills for Codex or ~/.claude/skills for Claude Code.