Grapple Join the waitlist

When something goes wrong.

When something fails, Grapple reaches the same result another way where one exists, or says in one sentence what failed and what to do, next to where you're looking. Here's what the common messages mean.

Ape and model runs

Ape asks you to set it up
Ape has no model yet. Your message waits while Set up Ape opens; finish the one step its row asks for. See model setup.
A run failed
The run shows the provider's own message, with Retry, Model settings and Copy details. Problems with a key, a spending limit or access to a model are fixed with the provider.
Claude Code or Codex doesn't answer
Check you're signed in through it, and that your plan with the provider is active.
A run seems to pause
Ape may be asking you a question in a card, or waiting for you to review a command if command review is set to Manual on the Ape page of Settings.
A run went the wrong way
Stop it, then choose Undo run, or Undo this on the steps you don't want.

The picture

"1 layer not shown"
One layer can't be drawn in the current view. Everything else still draws. Open the chip's list for the reason and the fix, such as Make layer 2D or Turn off Puppet.
Missing media
A file has moved or been renamed. Choose Relink on its row in the Project panel and point it at the file.
"Inputs changed"
A track, solve or other analysis was made before its footage or masks changed. The old result keeps showing; choose Run again to update it.
A frame fails on the GPU
If one frame's GPU work runs so long that the graphics card stops responding, that frame fails with a message naming the effect, and the next frame renders normally. Simplify the effect named, or update your graphics driver.
Playback is slow
Switch Preview quality to Draft while you edit, and set a short work range with B and N so playback loops over the part you're refining.

Edits that are refused

Grapple refuses an edit before it starts when it would be overwritten, and tells you where to make it instead. A row driven by an expression says "An expression sets this value. Edit it in Code, or turn the expression off to set a value." A row driven by a Link says to change its source or ranges, or remove it. A disabled control always says why.

Plugins and Python

"Needs your approval"
The plugin runs code and hasn't been approved for this version on your computer. Click its card and answer the dialog.
"Not available"
The card gives the reason. Executable plugins run isolated, and are unavailable where that isolation can't be applied.
Python doesn't run
The project came from someone else. Read the code if you like, then choose Trust project.
A problem in Code
The Problems tab lists each one; choose it to jump to the line.

Exports

A cancelled export writes nothing. When an export finishes, its summary names anything to know before sending it, such as analysis used while its inputs had changed, or frames filled in where tracking was lost. If the file won't write, choose a folder you can write to, with enough free space, and close any player that has the old file open.

Projects and updates

Projects open across versions. An older project is upgraded when you open it, and the original is kept as "Name (before upgrade)". A project saved by a newer Grapple is refused with a message saying so; update Grapple to open it.

Updates arrive in the background as small patches, and Restart to update waits while Ape is running. Crash reports stay on your computer and are sent only with your consent.

Send a diagnostics report

  1. Open Diagnostics from the Window menu. It's the panel for when something went wrong or feels slow.
  2. Choose Save report… and save the file. Private content is left out.
  3. Send it with the Grapple version, what you were doing and the message you saw.