Connect Recallium to your coding agent and recall your first project context
Recallium gives your coding agents durable project memory. Run the installer once, connect the agents already on your machine, and continue working in your repository.
To check your versions and install what is missing, see Prerequisites. Or have your agent check them: copy these instructions and paste them into it.Already using Recallium Community? Move your projects and memories first. See Migrate from Recallium Community.
The installer detects supported agents on your machine. The list depends on your operating system. See Supported clients.
One command wires every agent it finds on your machine and signs you in once. Run it again at any time to pick up a new agent.
npx -y recallium@latest install
The installer shows what it will change before it writes anything. If it stops or reports a problem, see Prerequisites and troubleshooting.
On Windows, PowerShell can block this command with running scripts is disabled on this system. See Troubleshooting to allow scripts for your account.
2
Authorize this client and choose your agents
The installer opens an interactive screen.
The Recallium installer: authorize the client, then pick the agents to connect.
Authorize this client. Complete the browser sign-in flow. The screen shows Client authorized when it succeeds.
Pick your agents. Under Found on this machine, select the agents you want to connect. Under More IDEs / agents, select any agent you use that the installer did not detect. Press space to pick one, or a to select all.
Start. Press s to apply the plan. The installer adds the MCP connection, Recallium guidance, and supported hooks for each selected agent.
3
Add the Claude Desktop plugin (chat agents only)
Chat agents such as Claude Desktop need one additional plugin. It carries the Recallium skill only. Its tools come from the connector that the installer registers in Claude Desktop.
Some agents ask you to authenticate the Recallium MCP server before first use. See Configure IDEs.Confirm the client, sign-in, and agent connections.
npx -y recallium@latest status
If a connection needs attention, run:
npx -y recallium@latest doctor
5
Open a repository and start working
Start your coding agent inside a Git repository. Recallium derives the project name from the repository and loads its context at the beginning of the session.Try asking:
What decisions and open tasks should I know about before I change the authentication flow?
On a new repository, ask your agent to create a Recallium project when it first has durable context to save.
If an existing Recallium project uses a different name from the repository, map it once with git config --local recallium.projectName existing-project-name.