Troubleshooting

Troubleshooting

"command not found" / nothing happens

Make sure you're running the bundled runtime with stock zsh:

zsh -f dist/mograph-jailed.zsh --request /tmp/mj-request.txt

The -f flag skips your personal shell config, which keeps behavior deterministic.

UNSUPPORTED: Project observation requires stock macOS python3

project.ingest, expression.lint, and project.snapshot need the macOS system Python 3 at /usr/bin/python3. No packages are installed — it just has to exist. On a stock Mac it does.

INVALID_PATH / INVALID_TARGET

Paths in request files must be absolute (/Users/you/..., not ~/... or relative). project.snapshot also requires the source to end in .aep.

PERMISSION_DENIED

The tool runs as you, with your permissions — it can't read files you can't read. Check Finder → Get Info → Sharing & Permissions.

SCRAPE_TOO_LARGE / SCHEMA_MISMATCH from ingest/lint

The receipt isn't a valid MJ_PROJECT_SCRAPE_1 document (or exceeds the 8 MB cap). Re-run the scraper (AE Scraper) — receipts from older builds may predate the schema.

Dashboard shows empty panels

It renders your data. Empty panels mean no data yet:

• No snapshots → run project.snapshot or install the Watcher.
• No vitals/lint → scrape a project in AE (AE Scraper) and pass --receipts pointing at the folder.

Watcher isn't firing

1. launchctl print gui/$(id -u)/com.neuralio.mograph-jailed.watcher — is it loaded?
2. tail ~/AE_Versions/watcher.log — every fire is logged; errors appear here.
3. System Settings → General → Login Items — is com.neuralio.mograph-jailed.watcher allowed in the background?
4. Remember: it fires on .aep changes, throttled to one scan per 30 seconds, max 2 levels deep.

The scraper did nothing / no receipt appeared

You must pick a destination folder in the save dialog — the scraper never writes anywhere you didn't choose. If the dialog never appeared, the script may have been blocked: check After Effects → Preferences → Scripting & Expressions → "Allow Scripts to Write Files and Access Network" (write access is needed for the receipt).

Still stuck?

Open an issue at https://github.com/NeuralIO444/Mograph_Jailed_OSX_CLI/issues with the command you ran and the full JSON response (error codes are stable and searchable).