MemPalace Memory Search
MemPalace/mempalace
Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.
Stores screenshots, PDFs, diagrams, fonts and other binary files in the Forgetful knowledge base, with a retrieval-friendly description and an attachment route.
Install Forgetful File Storage
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ScottRBK/forgetful forgetful-files --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/forgetful-files .claude/skills/forgetful-files && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .claude/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-filesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ScottRBK/forgetful forgetful-files --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/forgetful-files .agents/skills/forgetful-files && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .agents/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ScottRBK/forgetful forgetful-files --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/forgetful-files .cursor/skills/forgetful-files && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .cursor/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ScottRBK/forgetful.git --path skills/forgetful-files--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ScottRBK/forgetful forgetful-files --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/forgetful-files .gemini/skills/forgetful-files && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .gemini/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ScottRBK/forgetful forgetful-filesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/forgetful-files .github/skills/forgetful-files && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .github/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ScottRBK/forgetful --skill forgetful-files -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ScottRBK/forgetful forgetful-files --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/forgetful-files .opencode/skills/forgetful-files && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "forgetful-files" agent skill from https://github.com/ScottRBK/forgetful/tree/main/skills/forgetful-files into .opencode/skills/forgetful-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "forgetful-files", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
forgetful-files- GitHub stars
- 301
- Token cost
- ~618 tokens
- SKILL.md length
- 266 words
- Files
- 1
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- MIT
At a glance
Stores screenshots, PDFs, diagrams, fonts and other binary files in the Forgetful knowledge base, with a retrieval-friendly description and an attachment route.
- Works in 2 steps: Store with a retrieval-grade description → Attach it
- Keeping an architecture diagram or screenshot alongside project knowledge
- SKILL.md covers Invoking operations, Step 1 — Store with a… and Step 2 — Attach it
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
This skill files binary content into the Forgetful memory server through its create_file operation, which takes base64 content with a filename, MIME type, tags and a description. The description is the whole search surface, so it should say what the file shows and when to reach for it instead of repeating the filename. File operations are feature-flagged: if discovery does not list them, the server has FILES_ENABLED turned off.
Every file must also be attached so it is not lost when the session ends, either with a project_id at creation or later through update_file, or by linking it to a stored procedure as an asset with link_skill_to_file. Knowledge that discusses the file can be saved as a memory that cites the file ID. Operations run through the MCP execute_forgetful_tool or the forgetful CLI, and schemas are looked up at runtime instead of being listed in the skill.
When your agent uses it
- Keeping an architecture diagram or screenshot alongside project knowledge
- Bundling an asset with a stored procedure
- Saving a PDF spec in the knowledge base
Example prompts
- “Store this architecture diagram in Forgetful with a description of the auth flow it shows.”
- “Attach the PDF spec to the payments project in the knowledge base.”
- “Link this font file to the design system procedure as its asset.”
Requirements
- A Forgetful server with FILES_ENABLED turned on
- The Forgetful MCP tools or the forgetful CLI
- Pre-approved tools (allowed-tools): mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)
Workflow steps
2 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit ff45893. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
mcp__forgetful__discover_forgetful_toolsmcp__forgetful__how_to_use_forgetful_toolmcp__forgetful__execute_forgetful_toolBash(forgetful:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Forgetful File Storage loads about 618 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 266 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from ScottRBK/forgetful at commit ff45893, republished under its MIT licence (© ScottRBK). 266 words, ~618 tokens.
Download SKILL.mdSave it as
.claude/skills/forgetful-files/SKILL.md (or your agent's skills folder).- name
- forgetful-files
- description
- File binary content into the knowledge base — screenshots, PDFs, diagrams, fonts, assets. Use when a binary artifact is worth keeping alongside knowledge, or when a stored procedure needs a bundled asset. The description is the entire search surface: say what the file shows and when to reach for it.
- allowed-tools
- mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)
- license
- MIT
- tags
- files, binary, assets, multi-modal
Filing binary content
Files carry what text cannot: the screenshot that shows the bug, the architecture diagram, the PDF spec, the font a design system needs. Mechanics are thin; the judgment is in the description and the attachment.
File operations are feature-flagged — when discovery doesn't list them, the server has
FILES_ENABLED off.
Invoking operations
Operations are named by registry name (create_file, list_files, ...). Invoke via
whichever surface this agent has:
- MCP:
execute_forgetful_tool(tool_name="create_file", arguments={...}) - CLI:
forgetful call create_file --args '{"filename": "..."}' --json
Get any operation's schema at runtime: how_to_use_forgetful_tool (MCP) or
forgetful tools info <operation> (CLI) — schemas are deliberately not repeated here.
Step 1 — Store with a retrieval-grade description
create_file takes the content base64-encoded, with filename, mime_type, tags, and a
description. The description is what future retrieval sees — write what the file shows and
when someone would reach for it ("Auth service architecture diagram — component boundaries
and token flow, current as of the v2 redesign"), never just restating the filename.
Done when: the file is stored and its description answers "what is this and when is it used" on its own.
Step 2 — Attach it
A file no path leads to is lost the moment this session ends. Two attachment routes exist:
project_id(at create, or later viaupdate_file) puts the file in a project's world.link_skill_to_filebundles it to a stored procedure as its asset (seeforgetful-procedures).
For knowledge that discusses the file, save a memory (forgetful-remember) that cites
the file ID in its content, so recall surfaces the pointer.
Done when: at least one route reaches the file — its project, a linked procedure, or a citing memory.
© ScottRBK, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/forgetful-files of ScottRBK/forgetful.
Open the folder on GitHubat commit ff45893
Compare with similar skills
Forgetful File Storage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Forgetful File Storage this skillScottRBK/forgetful | 301 | — | ~618 | Automated safety check: Pass | MIT | |
| MemPalace Memory SearchMemPalace/mempalace | 59k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Context Mode Searchmksglu/context-mode | 26k | — | ~250 | Automated safety check: Pass | Custom licence | |
| Basic Memory Setupbasicmachines-co/basic-memory | 4.1k | — | ~3.9k | Automated safety check: Pass | AGPL-3.0 | |
| MemPalace MemoryMemPalace/mempalace | 59k | — | ~2.7k | Automated safety check: Pass | MIT | |
| Context Mode Indexermksglu/context-mode | 26k | — | ~328 | Automated safety check: Pass | Custom licence |
Similar skills
Context Mode Search
mksglu/context-mode
Search context-mode's persistent FTS5 knowledge base for previously indexed local project content, documentation, or session memory. Trigger…
Basic Memory Setup
basicmachines-co/basic-memory
Runs a short guided interview that configures the Basic Memory plugin for a project: project mapping, note schemas, folder conventions and capture habits.
MemPalace Memory
MemPalace/mempalace
Gives an agent a local memory palace over MCP: verbatim conversation memory, semantic search and a temporal knowledge graph, with a per-session recall protocol.
Context Mode Indexer
mksglu/context-mode
Indexes a local file or project directory into context-mode's FTS5 knowledge base so later searches return focused snippets instead of rereading whole files.
Auto Memory
tractorjuice/arc-kit
This skill should be used when the user asks to 'set up memory', 'create memory files', 'create MEMORY.md', 'set up topic files', 'improve memory organization', 'what should I remember', 'how to…
More from ScottRBK/forgetful
All 10 skills in this repoForgetful CLI Setup
ScottRBK/forgetful
Installs and connects the Forgetful CLI in local or remote mode, sets up token auth for CI, and proves the setup with a real round-trip call.
Forgetful Remember
ScottRBK/forgetful
Decides where a piece of knowledge belongs in the Forgetful memory server, checks for existing entries first, then creates and links it without deleting anything.
Forgetful Repo Encoding
ScottRBK/forgetful
Encodes a repository into the Forgetful knowledge base as a project, entities, atomic memories and documents, so a second run updates instead of duplicating.
Forgetful Entity Modeling
ScottRBK/forgetful
Models people, organisations, devices, products and system components as entities in a Forgetful knowledge graph, then links memories and relationships to them.
Forgetful Knowledge Graph Explorer
ScottRBK/forgetful
Explores the Forgetful memory graph in phases, walking memories, entities and relationships to answer cross-project and entity-centred questions.
Forgetful MCP Client Setup
ScottRBK/forgetful
Connects an MCP client to the Forgetful memory server over stdio or HTTP, then confirms the link works with discovery and round-trip calls.
Related
Works with
Categories
Questions about Forgetful File Storage
What does Forgetful File Storage do?
Stores screenshots, PDFs, diagrams, fonts and other binary files in the Forgetful knowledge base, with a retrieval-friendly description and an attachment route. This skill files binary content into the Forgetful memory server through its create_file operation, which takes base64 content with a filename, MIME type, tags and a description. The description is the whole search surface, so it should say what the file shows and when to reach for it instead of repeating the filename.
When should I use Forgetful File Storage?
Forgetful File Storage fits situations like: keeping an architecture diagram or screenshot alongside project knowledge; bundling an asset with a stored procedure; saving a PDF spec in the knowledge base.
How do I install Forgetful File Storage in Claude Code?
Run `npx skills add ScottRBK/forgetful --skill forgetful-files -a claude-code`. Or copy the skill folder (skills/forgetful-files in ScottRBK/forgetful) into .claude/skills/forgetful-files in your project. Claude Code loads it when a task matches its description.
How do I install Forgetful File Storage in Codex?
Run `npx skills add ScottRBK/forgetful --skill forgetful-files -a codex`. Or copy the skill folder (skills/forgetful-files in ScottRBK/forgetful) into .agents/skills/forgetful-files in your project. Codex loads it when a task matches its description.
Can I use Forgetful File Storage in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ScottRBK/forgetful --skill forgetful-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forgetful-files, .gemini/skills/forgetful-files, .github/skills/forgetful-files and .opencode/skills/forgetful-files in your project.
What does Forgetful File Storage need to run?
SKILL.md names no scripts, command-line tools or credentials: Forgetful File Storage is instructions for the agent only. Our summary lists: A Forgetful server with FILES_ENABLED turned on; The Forgetful MCP tools or the forgetful CLI. Its frontmatter pre-approves these tools: mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*).
Does Forgetful File Storage access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Forgetful File Storage safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Forgetful File Storage use?
Forgetful File Storage is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Forgetful File Storage use?
About 618 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Forgetful File Storage?
Skills that share tags, products or a category with Forgetful File Storage: MemPalace Memory Search (MemPalace/mempalace, 59k stars), Context Mode Search (mksglu/context-mode, 26k stars), Basic Memory Setup (basicmachines-co/basic-memory, 4.1k stars) and MemPalace Memory (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Forgetful File Storage?
ScottRBK (a GitHub user) maintains it in ScottRBK/forgetful, which has 301 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.
Source: ScottRBK/forgetful on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.