mem:init

Compatibility: If AskUserQuestion is unavailable, present options as a numbered list and wait for the user's reply. If Task is unavailable, run parallel steps sequentially. The context: fork and agent: frontmatter fields are Claude Code-specific — on OpenCode and VS Code Copilot they are ignored and the skill runs inline using the current model.

One-time project bootstrap. Sets up CLAUDE.md (and optionally AGENTS.md) so that team knowledge loads automatically at session start.

Step 1: Check if Already Configured

Search CLAUDE.md for mem list or ## Team Knowledge.

If found, report:

Already configured -- CLAUDE.md already has a mem section.

Stop here.

Step 2: Write CLAUDE.md Block

If CLAUDE.md does not exist, create it. Append the following block:

## Team Knowledge

At the start of every session, load project knowledge into context:

\`\`\`bash
npx @codevoyant/agent-kit mem list
\`\`\`

Step 3: Ask About AGENTS.md

AskUserQuestion:
  question: "Also add to AGENTS.md for OpenCode/Copilot compatibility?"
  options:
    - "Yes -- add to AGENTS.md too"
    - "No -- CLAUDE.md only"

If yes, write the same block to AGENTS.md (create if missing, append if exists).

Step 4: Ask About Claude Code Hook

AskUserQuestion:
  question: "Add a Claude Code hook to auto-load team knowledge on session start?"
  options:
    - "Yes -- add to .claude/settings.json"
    - "No -- I'll call it manually or via CLAUDE.md"

If hook selected, read .claude/settings.json (create if missing). Merge a UserPromptSubmit hook:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "npx @codevoyant/agent-kit mem list 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

Preserve any existing settings/hooks when merging.

Step 5: Report

mem:init complete

CLAUDE.md updated -- team knowledge will load every session.
Run /mem:learn to add your first piece of knowledge.
Or: npx @codevoyant/agent-kit mem learn