Troubleshooting

Troubleshooting

Permission errors creating .ai-knowledge

Ensure the --root directory is writable and that the process has permissions to create files and folders.

"topic is required" or "invalid topic name"

Provide a non-empty topic that does not contain / or \\, and is not . or ...

"knowledge for topic already exists"

Use refine_memory to update existing content or forget_memory to remove it before creating a new topic.

"knowledge for topic not found"

Confirm the topic exists with list_memories and check spelling/casing.

"No topics found matching the tags"

Ensure you pass at least one tag and that the tags match what is stored in the topic frontmatter.