Turn your Pieces Long-Term Memory into an AGENTS.md your coding agents can read.
Turn your Pieces Long-Term Memory into an AGENTS.md your coding agents can read. The pieces mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 2 defined tools rather than through you.
PiecesOS records what you work on all day. Your coding agent starts every session with none of it. This CLI reads your memory over MCP and writes the parts that belong to a repository into its context file, so the next agent already knows why the code looks the way it does.
Agent context files have become the standard way to tell Claude Code, Cursor or Copilot how a project works. Almost nobody keeps them current, because writing down what you already know is the first task to get dropped. Meanwhile PiecesOS has been quietly recording the decisions, the bugs and the dead ends the whole time.
Everything the assistant can do here goes through one of these:
Principle — What it means in practiceFlag — DefaultInstallation goes through your MCP client rather than a global install: point it at pieces-to-agents on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
39300 - Node.js 20.11 or newer - A git repository to write intoPlenty of knowledge and memory servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Pieces's toolset — Principle, Flag — is a fair guide to whether it matches your workflow. It is maintained by tiagolauer; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Principle | What it means in practice |
| Flag | Default |
{
"mcpServers": {
"pieces": {
"command": "npx",
"args": ["-y", "pieces-to-agents"]
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
39300 - Node.js 20.11 or newer - A git repository to write intoA knowledge graph your assistant keeps between sessions — entities, relations and observations that persist.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
A structured scratchpad for hard problems — stepwise reasoning with revisions, branches and visible logic.
Symbol-level code navigation, refactoring and memory for coding agents — the IDE brain your assistant has been missing.
Chat with your second brain — search, read and write vault notes through the Local REST API.