by psinetron
Persistent memory plugin for Codex. Obsidian-style knowledge base that survives across sessions
# Add to your Claude Code skills
git clone https://github.com/psinetron/echoes-vault-codexGuides for using ai agents skills like echoes-vault-codex.
echoes-vault-codex is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by psinetron. Persistent memory plugin for Codex. Obsidian-style knowledge base that survives across sessions. It has 109 GitHub stars.
echoes-vault-codex's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/psinetron/echoes-vault-codex" and add it to your Claude Code skills directory (see the Installation section above).
echoes-vault-codex is primarily written in Python. It is open-source under psinetron on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh echoes-vault-codex against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
EchoesVault is a persistent memory plugin for Codex and a portable project-memory protocol for Codex, OpenCode, Claude, and other coding agents. Codex bootstraps a shared runtime and agent instructions into the repository; after that, every supported agent uses the same validation, locking, logs, and deterministic index. Knowledge stays in plain Markdown, remains readable without any agent, works naturally with Git, and opens as an Obsidian-compatible vault.
Current release: 1.0.0 · Protocol: 1.0.0
Install the plugin once:
codex plugin marketplace add psinetron/echoes-vault-codex
codex plugin add echoes-vault-codex@echoes-vault
Start a new Codex task in the repository that should own the memory and ask in any language:
Initialize EchoesVault for this project.
Инициализируй EchoesVault для этого проекта.
Then use natural language rather than memorizing commands:
Restore project memory.
Show EchoesVault status.
Remember this architectural decision.
Save and finish this EchoesVault session.
Initialization is project-local. The globally installed Codex plugin stays silent in every other repository until EchoesVault is initialized there. Commit the generated protocol, portable runtime, and adapters so Codex, OpenCode, Claude, and teammates all follow the same rules.
python3.Review the bundled SessionStart hook before enabling the plugin if your
environment requires auditing third-party commands.
This repository contains a Codex marketplace manifest. Add it as a marketplace source:
codex plugin marketplace add psinetron/echoes-vault-codex
Then choose either installation method.
Interactive plugin browser:
codex
/plugins
Open the EchoesVault marketplace, select EchoesVault for Codex, install it, and make sure it is enabled. Start a new Codex session after installation.
Direct CLI installation:
codex plugin add echoes-vault-codex@echoes-vault
Verify the result:
codex plugin list
The expected entry is echoes-vault-codex@echoes-vault with status installed, enabled.
codex plugin marketplace add psinetron/echoes-vault-codex once in a terminal.Clone the repository:
git clone https://github.com/psinetron/echoes-vault-codex.git
cd echoes-vault-codex
Run the tests before installing:
python3 -m unittest discover -s tests -v
Ask Codex to connect the existing folder to your personal marketplace:
Use $plugin-creator to add the existing plugin in the current directory to my personal
marketplace, install it, and use the cachebuster update flow for future local changes.
The standard personal marketplace lives at ~/.agents/plugins/marketplace.json. Do not replace
that file if it already contains other plugins; let $plugin-creator merge the entry safely.
After each local code change:
$plugin-creator to update the cachebuster and reinstall echoes-vault-codex.The plugin is installed once for Codex but remains silent in projects that do not have an EchoesVault. Open the target project in a new task and ask in any language, for example:
Initialize EchoesVault for this project.
Инициализируй EchoesVault для этого проекта.
Подключи локальную память проекта.
Exact skill names are optional. You can also invoke $echoes-init explicitly. Initialization
creates only repository-local files:
EchoesVault/
├── .echoes-vault.json
├── .gitignore
├── AGENT_PROTOCOL.md # shared contract for every agent
├── index.md # generated locally; ignored by Git
├── pages/
├── daily/YYYY-MM-DD/ # one unique file per write
├── assets/
└── raw/
.echoes-vault/
├── .gitignore
├── echoes_vault.py # portable runtime; committed to Git
├── state.json # local runtime state; ignored by Git
└── lock # short-lived local lock; ignored by Git
AGENTS.md # managed block for Codex/OpenCode
CLAUDE.md # managed block for Claude
.claude/skills/echoes-vault/SKILL.md
.opencode/skills/echoes-vault/SKILL.md
.opencode/commands/echoes-init.md
.opencode/commands/echoes-start.md
.opencode/commands/echoes-status.md
.opencode/commands/echoes-end.md
On later tasks, the first response includes a status card for initialized projects. Other projects remain unaffected and show no card.
Codex is convenient for installing and initializing EchoesVault, but it is not required after the portable files have been created. To bootstrap a project without Codex, clone or download this repository once and run its bundled engine against the target project:
git clone https://github.com/psinetron/echoes-vault-codex.git
python3 echoes-vault-codex/scripts/echoes_vault.py \
--workspace /path/to/your/project init
Commit the generated protocol, portable runtime, and adapters in the target project. Teammates and
other agents then use .echoes-vault/echoes_vault.py from that project and do not need a global
EchoesVault installation.
Refresh all configured marketplaces:
codex plugin marketplace upgrade
Or refresh only EchoesVault:
codex plugin marketplace upgrade echoes-vault
Open /plugins in Codex CLI or the Plugins page in the desktop app, reinstall/update the plugin,
and start a new task. If Codex still loads an older local development build, use
$plugin-creator to apply a new cachebuster before reinstalling.
In Codex CLI, open codex, enter /plugins, select the installed plugin, and either disable it or
uninstall it. In the desktop app, open the plugin under Installed and select Uninstall
plugin.
Remove the marketplace source only when you no longer need it:
codex plugin marketplace remove echoes-vault
Uninstalling the Codex plugin does not delete project knowledge or its portable runtime.
Initialized repositories continue to contain EchoesVault/, .echoes-vault/echoes_vault.py, and
the agent adapters. They can be used by another supported agent or read as plain Markdown.
| Symptom | Check |
|---|---|
| Marketplace does not appear | Run codex plugin marketplace list, then restart the desktop app. |
| Plugin is installed but skills are missing | Start a new Codex task or CLI session. |
| Status card does not appear | Confirm that the project contains EchoesVault/.echoes-vault.json; legacy vaults may still be detected by index.md. |
| Hook reports a Python error | Run python3 --version; version 3.9+ must be on PATH. |
| Local edits are ignored | Update the manifest cachebuster, reinstall, and start a new task. |
| You do not want memory in a project | Do not initialize it; the globally installed plugin remains silent there. |