Troubleshooting

Troubleshooting

Files are not visible to the agent

• Check they are tracked: git status
• Check ignore rules: git status --ignored
• Refresh index: agentinit refresh-llms

status --check fails

• Fill placeholders in reported files.
• Fix broken links across docs.
• Re-run:

agentinit status --check
agentinit sync --check
agentinit lint

Router files are out of sync

If CLAUDE.md, GEMINI.md, Cursor, or Copilot router files drift from the shipped templates:

agentinit sync
agentinit sync --check

A managed path is reported as a symlink

agentinit skips writes to managed files that are symlinks or resolve outside the project root.

If you see a warning like managed path is a symlink:

• replace the managed file with a regular file inside the repo, or
• remove the symlink and rerun the command

Too many duplicate warnings

• Reduce repeated content in router files.
• Move central rules to AGENTS.md.
• Keep routers as pointers to docs, or direct @ imports where supported by the tool.

Purpose is in Italian/French/Spanish

Use:

agentinit init --purpose "..." --translate-purpose

Or with detect:

agentinit init --detect --purpose "..."

(Non-English purpose is translated for docs/*.)