{"id":51177901,"url":"https://github.com/lijingda/memory-skill","last_synced_at":"2026-06-27T05:02:40.486Z","repository":{"id":365420575,"uuid":"1272006814","full_name":"lijingda/memory-skill","owner":"lijingda","description":"Project-level memory skill for AI coding agents.","archived":false,"fork":false,"pushed_at":"2026-06-17T10:00:10.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-17T10:05:17.452Z","etag":null,"topics":["agent-memory","agent-tools","ai","ai-agents","automation","cli","codex","codex-skills","coding-agents","knowledge-management","local-first","markdown","memory","project-memory","skills"],"latest_commit_sha":null,"homepage":"https://github.com/lijingda/memory-skill#install","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lijingda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-17T07:49:08.000Z","updated_at":"2026-06-17T10:00:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lijingda/memory-skill","commit_stats":null,"previous_names":["lijingda/memory-skill"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/lijingda/memory-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lijingda%2Fmemory-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lijingda%2Fmemory-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lijingda%2Fmemory-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lijingda%2Fmemory-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lijingda","download_url":"https://codeload.github.com/lijingda/memory-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lijingda%2Fmemory-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34841992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-memory","agent-tools","ai","ai-agents","automation","cli","codex","codex-skills","coding-agents","knowledge-management","local-first","markdown","memory","project-memory","skills"],"created_at":"2026-06-27T05:02:39.678Z","updated_at":"2026-06-27T05:02:40.481Z","avatar_url":"https://github.com/lijingda.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# project-memory skill\n\nA project-level memory skill for coding agents.\n\n`project-memory` gives an agent a small, durable place to store knowledge that\nshould survive across sessions but does not belong in source code: hard-won\ndebugging lessons, non-obvious project conventions, decisions and their reasons,\nand local commands that are easy to forget.\n\nThe skill is intentionally conservative. It tells the agent to read memory at\nthe start of work, write only durable and non-obvious facts, update stale entries\nwhen code proves them wrong, and avoid bypassing the bundled script.\n\n## Install\n\nInstall with the `skills` CLI:\n\n```bash\nnpx skills add https://github.com/lijingda/memory-skill --skill project-memory\n```\n\nTo list available skills before installing:\n\n```bash\nnpx skills add https://github.com/lijingda/memory-skill --list\n```\n\nTo install specifically for Codex:\n\n```bash\nnpx skills add https://github.com/lijingda/memory-skill --skill project-memory --agent codex\n```\n\nManual fallback: copy or symlink `skills/project-memory` into the skills\ndirectory used by your agent runtime.\n\n## What It Does\n\n`project-memory` teaches an agent when to read, write, update, and remove\nproject-level memory entries. Entries are stored per project in\n`.agent-memory/memory.md`; that store is intentionally ignored by git.\nThe command's `cwd` determines the project: the script reads and writes only\n`cwd/.agent-memory/memory.md`.\n\nThe bundled script has no third-party dependencies and runs with Node.js:\n\n```bash\nnode skills/project-memory/scripts/memory.mjs help\n```\n\n## Body Input\n\nEntry bodies are accepted through `--stdin` or `--file`; there is no `--body`\nmode. This avoids shell escaping surprises when memory includes Markdown, code,\nbackticks, `$`, or quotes.\n\nUse `--stdin` for short or moderate entries:\n\n```bash\nnode skills/project-memory/scripts/memory.mjs add --title \"Current plan path\" --type reference --tags docs --stdin \u003c\u003c'EOF'\nThe durable planning file is `docs/current-plan.md`; do not replace `$PROJECT_ROOT` before reading it.\nEOF\n```\n\nUse `--file` for longer prepared entries or content that already exists in a\nfile:\n\n```bash\nnode skills/project-memory/scripts/memory.mjs update 3 --file /tmp/project-memory-entry.md\n```\n\n## Development\n\nFor local development in this repository, use the script from the repo root:\n\n```bash\nnode skills/project-memory/scripts/memory.mjs list\n```\n\nRun the checks:\n\n```bash\nnpm test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flijingda%2Fmemory-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flijingda%2Fmemory-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flijingda%2Fmemory-skill/lists"}