pensieve-search

pensieve-search is a skill for Claude Code, Codex from arkohut/pensieve. It costs 136 tokens per session (9,177 once invoked), scanned C, original, Apache-2.0.

A tool for searching Pensieve, a local archive that continuously captures and indexes screenshots from your computer. Searches can use text, applications, or time ranges.

In plain words
What is it for?
Use it to find screenshots of a project, application, topic, or date range, then open the matching screenshot in Pensieve's web interface.
Why use it?
It helps locate a past screen or work session when you remember what was visible but not where the screenshot file is.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: positional $N argument; mentions Claude Code; mentions Codex.

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/.../screenshots/20260423/00001.webp.

Good fit Use it to find screenshots of a project, application, topic, or date range, then open the matching screenshot in Pensieve's web interface.

Compare 6 skills from other repositories ↓
About the project

Pensieve is a privacy-focused screen recorder that automatically captures screenshots, indexes them, and stores the records locally for later retrieval. It is for people who want to search and review their computer activity while keeping control of the data. Its catalogue skill lets coding agents search the screenshot archive in natural language.

arkohut/pensieve · 1,387 stars · on GitHub

Install

Getting it into your agent

There is no command for this one: it runs only inside a plugin, and the catalogue could not identify which plugin ships it. The source is linked below.

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pensieve-search

README.md
[![agentmods](https://agentmods.dev/badge/skills/arkohut/pensieve/pensieve-search/github.svg)](https://agentmods.dev/skills/arkohut/pensieve/pensieve-search)
Your own site
<a href="https://agentmods.dev/skills/arkohut/pensieve/pensieve-search"><img src="https://agentmods.dev/badge/skills/arkohut/pensieve/pensieve-search/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pensieve-search

Your own site · 80×15
<a href="https://agentmods.dev/skills/arkohut/pensieve/pensieve-search"><img src="https://agentmods.dev/badge/skills/arkohut/pensieve/pensieve-search.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 9,177 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00136 $0.09177
Opus 5 $0.00068 $0.04588
Sonnet 5 $0.00027 $0.01835
Haiku 4.5 $0.00014 $0.00918

Measured 11d ago against content hash e5ff58f6a999, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade C, and why

pensieve-search scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf "$TMPDIR"

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s -o /dev/null -w "%{http_code}\n" "http://127.0.0.1:8839/api/search?q=test"
skills/pensieve-search/SKILL.md · 567 lines

How it starts

The opening of the file, as written. The whole thing — 567 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Pensieve Search Skill

Pensieve (memos) continuously captures screenshots and indexes them. This skill teaches you to query that index over its HTTP API.

Where the data lives

  • Server: http://127.0.0.1:8839 by default (config: server_host / server_port).
    • Override with MEMOS_SERVER_HOST / MEMOS_SERVER_PORT env vars or ~/.memos/config.yaml if the user has a non-default setup. Confirm with the user if the default doesn't respond.
  • Screenshots on disk: ~/.memos/screenshots/YYYYMMDD/<entity>.webp. The API returns filepath directly so you don't have to compute it.
  • Web UI (same server, browser-friendly):
    • Search page (mirrors API filters as URL params): http://127.0.0.1:8839/?q=...&start=...&end=...&app_names=...&library_ids=... — you should always offer this URL in your reply so the user can click and verify results visually.
    • Entity detail page: http://127.0.0.1:8839/entities/<id> — opens one specific screenshot in context with its metadata. Offer this for any hit you cite.
    • Config page: http://127.0.0.1:8839/config — surface this if the user asks about settings.

Pre-flight check

Before the first query in a session, verify the server is up:

curl -s -o /dev/null -w "%{http_code}\n" "http://127.0.0.1:8839/api/search?q=test"

200 means good. 000 or connection-refused means memos isn't running — tell the user to start it (memos serve or system-service).

Always quote the URL — the ? and & are zsh glob characters and will fail with no matches found if unquoted. Every curl example below assumes a quoted URL.

The endpoint

GET /api/search

Parameters:

Param Type Notes
q string Full-text query (jieba-tokenized; works for Chinese + English mixed). Empty q="" returns recent screenshots without ranking.
start, end int (UNIX seconds, UTC) Time window on file_created_at. Both required together.
app_names string Comma-separated active_app values, e.g. "Google Chrome,iTerm2".
library_ids string Comma-separated; usually leave unset to query all.
limit int 1..200 Default 48. Use 10–20 for casual queries, 200 only when scanning.
facet bool Include facet_counts (per-app counts), date_range (earliest/latest), and date_buckets (count per day or month, see Strategy 5). Set true on broad queries to help narrow.
date string Bucket filter, YYYY-MM or YYYY-MM-DD. Intersected with start/end.

Read the full file on GitHub · 567 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 567 lines · 136 tokens per session scan C e5ff58f6a999

Subscribe to this mod's changes

pensieve-search is a skill published in the GitHub repository arkohut/pensieve (1,387 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 136 tokens to every session and 9,177 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it C with 2 findings (recursive force delete, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

Cortex

Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…

danielmiessler/LifeOS · 196 tokens

Migrate

Intakes external content, classifies chunks against LifeOS taxonomy, commits with provenance. Sources: .md/.txt, stdin, LifeOS dirs, CLAUDE.md/Cursor/OpenAI Custom Instructions, Obsidian/Notion/Apple Notes exports. MigrateScan classifies → routing table. MigrateApprove with…

danielmiessler/LifeOS · 158 tokens

daily-briefing

Proactive daily briefing that fires on a recurring schedule, pulls recent memory and workspace context, composes a structured summary (action items, progress, radar, next steps), and delivers it to all active channels. Enable with a time like "set up my daily briefing at 9am". Disable, reschedule, or check status at…

vellum-ai/vellum-assistant · 75 tokens

company-brain

Your team's shared, AI-ready knowledge base — people, companies, meetings, SOPs, and decisions structured so Claude can answer questions on your team's behalf. Team-scope sibling to second-brain (which is personal-scope). Seven modes — capture (drop something into the right structured dir), compile (process into wiki…

coreyhaines31/makerskills · 322 tokens

calendar

Manage calendar events via CalDAV (Google/iCloud/Nextcloud) or local ICS files. View, create, and query events.

fuyuxiang/echo-agent · 29 tokens

email-assistant

Read, search, draft, and send emails via Himalaya CLI or Python IMAP/SMTP. Requires email account configuration.

fuyuxiang/echo-agent · 29 tokens