> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recallium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common connection, search, and project-context problems

## My agent is not remembering anything

First confirm that Recallium is connected:

```bash theme={null}
recallium status
recallium doctor
```

Then make the request explicit and complete:

> Remember this JWT implementation, including refresh-token rotation, the security trade-off, and the files we changed.

Look for the agent's confirmation that the memory was stored.

## Search returns nothing

Use a broader natural-language topic instead of an exact function or symbol name.

Try:

> Search our memories for user authentication and token validation.

If you know the file, include it as a second clue.

## The result comes from the wrong project

Name the project and topic in the request:

> Find authentication decisions in the `payment-service` project.

Check the repository mapping when the current clone uses a different name:

```bash theme={null}
git config --local --get recallium.projectName
```

## Search returns too many results

Add the kind of context, directory, or time window you need:

> Find recent authentication decisions related to files under `src/auth/`.

Ask the agent to expand only the strongest matches before using their details.

## A different coding agent cannot find the same context

Run `recallium status` from the machine and confirm that both agents are connected. Make sure both sessions resolve to the same Recallium project.

If necessary, map the repository explicitly:

```bash theme={null}
git config --local recallium.projectName existing-project-name
```

## Cloud sign-in expired

Sign in again without reinstalling:

```bash theme={null}
recallium login
```

## I still need help

Email [support@recallium.ai](mailto:support@recallium.ai). Include:

* Your operating system
* The coding agent you are connecting
* The output from `recallium status`
* The output from `recallium doctor`
* The step that failed