Skip to content
Agent Package Manager

Common errors

This page lists error messages and silent failures that users report most frequently, along with their cause and the shortest path to a fix.

Cursor: “Config version must be a number”

Section titled “Cursor: “Config version must be a number””

Symptom: Cursor reports Config version must be a number or Failed to parse project hooks configuration, or silently loads no project hooks even though apm install succeeded and .cursor/hooks.json exists.

Cause: APM versions v0.14.1—v0.20.0 omitted the required top-level "version": 1 field from .cursor/hooks.json. Cursor rejects the entire file when that field is absent.

Fix: Re-run hook integration to regenerate a valid config:

Terminal window
apm install --target cursor

Or, if you install all targets at once:

Terminal window
apm install

APM v0.21.0+ always writes "version": 1 to .cursor/hooks.json on a fresh install. Existing files that already contain a "version" key are left untouched.