ricordo
User guide · 100% local

How to get the most out of
your second brain

Ricordo remembers what you see on your computer and tells you when you ask. Here's everything: installing, granting permission, asking well, and why your life never leaves your machine.

1 · What it is 2 · Install 3 · The permission 4 · The AI 5 · How to ask 6 · Tips 7 · Privacy 8 · If something fails

1 · What Ricordo is (in 20 seconds)

Ricordo is a desktop application that runs in the background and keeps —only on your computer— a record of what appears on your screen: text, websites, apps, conversations. Then you ask it in your own language and it answers citing when and in which app you saw it.

It's like having a photographic memory of your digital life. The difference with other similar apps (Littlebird, Rewind…): your life doesn't travel to anyone's cloud, and it runs on Mac, Windows and Linux.

2 · Install (two clicks)

1
Download your version

At ricordo.blog, choose Mac, Windows or Linux. A file downloads.

2
Open it

Mac: open the .dmg and drag Ricordo to Applications. Windows: run the installer. Linux: give execution permission to the .AppImage and open it.

3
The first time, a security warning

Since Ricordo is still young, the system may warn you it's from an "unidentified developer". That's normal. Mac: right-click on the app → Open. Windows: More info → Run anyway.

3 · The permission (the step that turns everything on)

To be able to remember, Ricordo needs your permission to see the screen. The first time you open it, a welcome screen guides you. All you have to do:

1
Click "Grant permission"

System Settings opens on the Screen Recording section.

2
Turn on Ricordo in the list

Check the box next to Ricordo (on Mac: Settings › Privacy & Security › Screen Recording).

3
Done — it starts remembering on its own

Within seconds, the app tells you "Now remembering!" and the dot at the top turns turquoise. From there, you don't have to do anything else.

Always onRicordo keeps remembering even if you close the window — it's your second brain, it works in the background. The turquoise dot at the top with "remembering · N memories · 0 min ago" confirms it's alive.

4 · Plugging in the AI (once)

Ricordo captures and searches everything on your computer, but to write your answer it uses an AI model. You plug in a key (free) just once:

Open Settings (the gear top right)

Paste your Google Gemini key — it's the required one, and it's free at aistudio.google.com/apikey.

+
(Optional) Claude key

If you want more elaborate answers for hard questions (long summaries), add a Claude/Anthropic key. Ricordo uses Gemini for the easy stuff and Claude for the hard stuff, automatically.

Your keys stay on your computerThey're stored only on your machine (~/.ricordo/config.json), never uploaded anywhere.

5 · How to ask

Type in the box below (or tap an example) and click recall. Ricordo lights up the "nodes" of your mind it used and answers citing time and app. There are three ways to ask:

▹ Summarizing your activity

To have it tell you what you've done, with a time window:

what did I do today?summarize the last 2 hourswhat did I do yesterday?what have I done this week?

It understands "today", "yesterday", "this week", "the last hour" and "the last N hours".

▹ Recalling something specific

To rescue a piece of data, a message, a website:

what did they tell me on WhatsApp?what did that bank email say?what did ChatGPT reply about X?what was that website I looked at?

▹ Searching by topic

To gather everything you've seen about something:

what have I seen about artificial intelligence?what did I read about mortgages?

6 · Tips to make it get it right more often

7 · Privacy — what stays and what (doesn't) leave

This is Ricordo's reason for being. Know exactly what happens to your data:

WhatWhere it goes
Everything Ricordo captures from your screenStays on your computer. Never uploaded to any cloud.
The search over your memory100% local, on your own machine.
When you ask for a cloud AI answerOnly your question + the exact fragments travel to the model you chose, with your key. Never your entire database.
The old stuffCleans itself up after 45 days (the text stays searchable; the space is reclaimed).
Your life doesn't train anyoneYour activity doesn't feed any company's artificial intelligence. It's yours, period.

8 · If something fails

"It doesn't remember anything / says it can't find anything"

It's almost always the Screen Recording permission. Look at the dot at the top: if it's not turquoise with "remembering…", go to Settings › Privacy › Screen Recording and turn on Ricordo. It could also just be capturing for a short while: give it some time.

"Missing Gemini key"

Open the gear ⚙ at the top right and paste your key (free at aistudio.google.com/apikey).

"It brings up things from another day when I ask about today"

Add the time word to the question ("today", "last 2 hours"). And remember: if your computer was off or asleep, those hours have no memories — that's normal.

"The summary left something out"

For long periods, Ricordo samples your activity. If you want the detail of a moment, ask something more specific about that window.