https://github.com/lijingda/memory-skill
Project-level memory skill for AI coding agents.
https://github.com/lijingda/memory-skill
agent-memory agent-tools ai ai-agents automation cli codex codex-skills coding-agents knowledge-management local-first markdown memory project-memory skills
Last synced: 6 days ago
JSON representation
Project-level memory skill for AI coding agents.
- Host: GitHub
- URL: https://github.com/lijingda/memory-skill
- Owner: lijingda
- License: mit
- Created: 2026-06-17T07:49:08.000Z (16 days ago)
- Default Branch: main
- Last Pushed: 2026-06-17T10:00:10.000Z (16 days ago)
- Last Synced: 2026-06-17T10:05:17.452Z (16 days ago)
- Topics: agent-memory, agent-tools, ai, ai-agents, automation, cli, codex, codex-skills, coding-agents, knowledge-management, local-first, markdown, memory, project-memory, skills
- Language: JavaScript
- Homepage: https://github.com/lijingda/memory-skill#install
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# project-memory skill
A project-level memory skill for coding agents.
`project-memory` gives an agent a small, durable place to store knowledge that
should survive across sessions but does not belong in source code: hard-won
debugging lessons, non-obvious project conventions, decisions and their reasons,
and local commands that are easy to forget.
The skill is intentionally conservative. It tells the agent to read memory at
the start of work, write only durable and non-obvious facts, update stale entries
when code proves them wrong, and avoid bypassing the bundled script.
## Install
Install with the `skills` CLI:
```bash
npx skills add https://github.com/lijingda/memory-skill --skill project-memory
```
To list available skills before installing:
```bash
npx skills add https://github.com/lijingda/memory-skill --list
```
To install specifically for Codex:
```bash
npx skills add https://github.com/lijingda/memory-skill --skill project-memory --agent codex
```
Manual fallback: copy or symlink `skills/project-memory` into the skills
directory used by your agent runtime.
## What It Does
`project-memory` teaches an agent when to read, write, update, and remove
project-level memory entries. Entries are stored per project in
`.agent-memory/memory.md`; that store is intentionally ignored by git.
The command's `cwd` determines the project: the script reads and writes only
`cwd/.agent-memory/memory.md`.
The bundled script has no third-party dependencies and runs with Node.js:
```bash
node skills/project-memory/scripts/memory.mjs help
```
## Body Input
Entry bodies are accepted through `--stdin` or `--file`; there is no `--body`
mode. This avoids shell escaping surprises when memory includes Markdown, code,
backticks, `$`, or quotes.
Use `--stdin` for short or moderate entries:
```bash
node skills/project-memory/scripts/memory.mjs add --title "Current plan path" --type reference --tags docs --stdin <<'EOF'
The durable planning file is `docs/current-plan.md`; do not replace `$PROJECT_ROOT` before reading it.
EOF
```
Use `--file` for longer prepared entries or content that already exists in a
file:
```bash
node skills/project-memory/scripts/memory.mjs update 3 --file /tmp/project-memory-entry.md
```
## Development
For local development in this repository, use the script from the repo root:
```bash
node skills/project-memory/scripts/memory.mjs list
```
Run the checks:
```bash
npm test
```