agent-memory

Agent Memory

Initialize the current project with the taichuy/agentMemory memory template. The goal is to make project memory available to coding agents without asking the user to paste the remote install command.

Workflow

1. Treat the current working directory as the target project unless the user gives another path.

2. Do not overwrite an existing .memory/ directory unless the user explicitly asks for force/overwrite.

3. Prefer the bundled installer from this skill directory. Use the known skill path if the tool exposes it; otherwise try the global paths created by the installer:

   python <skill-dir>/scripts/install-memory.py --dest .
   python "$HOME/.codex/skills/agent-memory/scripts/install-memory.py" --dest .
   python "$HOME/.claude/skills/agent-memory/scripts/install-memory.py" --dest .
   python "$HOME/.config/opencode/skills/agent-memory/scripts/install-memory.py" --dest .
   python "$HOME/.gemini/skills/agent-memory/scripts/install-memory.py" --dest .
   

   In Claude Code, ${CLAUDE_SKILL_DIR} may be used as <skill-dir>. If python is unavailable, try python3 or py. If the user asked to replace an existing .memory/, add --force.

4. If the bundled script cannot run, manually copy assets/memory-template/.memory into the target project as .memory, then create or update these root files:

   • AGENTS.md
   • CLAUDE.md
   • GEMINI.md

5. The root instruction files must contain this block, or an equivalent existing reference:

   # 记忆
   命中对应`记忆存储规则`自动更新对应记忆中
   @.memory/AGENTS.md
   
   ## 用户偏好
   @.memory/user-memory.md
   

6. If a root instruction file already exists and already references .memory/AGENTS.md and .memory/user-memory.md, leave it unchanged.

7. If a root instruction file exists but lacks the memory references, append the memory block instead of replacing the user's content.

8. Finish by reporting whether .memory/ was installed, kept, or replaced, and which instruction files were created or updated.

9. Before ending the turn, infer the user's primary communication language from the current conversation and project files. Ask in that language whether to initialize .memory/user-memory.md. Do not write user memory before the user confirms.

10. If the user confirms, ask one compact initialization question group adapted to the project context. Include: