Skip to content

node-pty failures

Native ABI or execute-permission problems with node-pty should be repaired directly, before assuming an agent-level bug.

node-pty backs Antigravity's entire integration and the raw terminal drawer available for every session — a failure here can look like a broader "agent won't start" problem when it's actually just this one native module.

Electron ABI mismatch

If node-pty fails to load — commonly right after an Electron or Node.js version change when building from source — rebuild it against the installed Electron:

bash
npm run rebuild:native
npm run native:check

spawn-helper execute permission

node-pty's native spawn-helper binary can lose its execute bit during install on macOS or Linux. This is normally fixed automatically by the postinstall script (and again before macOS packaging builds), but can be run manually:

bash
node scripts/fix-native-permissions.js

Related