Every user-facing error has a stable code so the friendly logger can link to
a fix. Codes follow AGS-<CATEGORY>-<NUMBER>.
| Code | Meaning |
|---|---|
AGS-CFG-001 |
.agentsync/config.yaml is missing. Run agentsync init. |
AGS-CFG-002 |
Could not parse or validate config.yaml. Check YAML syntax and schema. |
AGS-CFG-003 |
No agents are enabled. Enable at least one target in config.yaml. |
AGS-RULE-001 |
A rule's frontmatter does not match the schema. |
AGS-RULE-002 |
A rule targets an unknown agent id. |
AGS-PROMPT-001 |
A prompt's frontmatter does not match the schema. |
AGS-PROMPT-002 |
Template rendering failed. A variable referenced in {{ }} is missing from variables:. |
AGS-FS-001 |
A path escapes the project root (absolute path or .. traversal). |
AGS-FS-002 |
A symlink resolves outside the project root. |
AGS-FS-003 |
Refusing to overwrite a manually edited generated file. Move your edits into .agentsync/ or pass --force. |
AGS-FS-004 |
Not a Git repository. |
AGS-SEC-001 |
A potential secret was detected in .agentsync/. Remove it or use a placeholder. |
AGS-BUILD-001 |
Unknown compiler target. |
AGS-BUILD-002 |
Build failed (generic). |
AGS-CHECK-001 |
agentsync check detected drift. Run agentsync build. |
If you hit an error code that's missing from this table, open an issue — that's a bug in AgentSync's UX.