Resources
FAQ
Answers to common Agent Needle questions.
Does Agent Needle require a database?
No. Its backend is Git-tracked Markdown. The repository provides persistence, review history, and portability.
Does it send project data to a service?
Agent Needle itself does not run a service or transmit data. The coding agent and tools you choose still have their own data-handling terms and permissions.
Should every task create memory?
No. Record only information that improves a future decision or resumption. Trivial work and facts already obvious from the repository usually do not need memory.
Can memory override the code?
No. The current repository and environment are authoritative. Memory is a map that must be checked against the terrain.
Why separate active, episodic, state, and decision memory?
They answer different questions: what is unfinished, what happened, what is currently true, and why a consequential choice was made. Separation makes retrieval more precise.
Can I edit the templates?
Yes. Agent Needle is MIT licensed. Keep the safety boundaries and verification discipline intact when adapting it to a team.
How do I uninstall it?
Remove AGENTS.md, .agent/, .memory/, and the optional CLAUDE.md adapter after preserving any project knowledge you still need. Review .gitignore before removing Agent Needle entries.