TT-Wang/cortex-plugin

Opt-in mining

Install no longer starts any background processes. The miner daemon is strictly opt-in — you get a clean silent install, type /memem to see the welcome and status, then explicitly choose whether to start mining.

The new flow

1. /plugin install memem → bootstrap verifies environment (Python, uv, venv, dirs), nothing else runs
2. Type /memem → see ASCII banner, live status, and the two mining options
3. Choose one:
   • /memem-mine — mine new sessions only (ongoing)
   • /memem-mine-history — mine all past history + start ongoing miner
   • Or just say "start mining new sessions" / "start mining everything including history" to Claude — it knows what to do

Opt-out

python3 -m memem.server --miner-opt-out

Stops the daemon and removes the opt-in marker so it won't auto-start next time.

Changed

• Miner is opt-in. storage._auto_start_miner() now early-returns unless ~/.memem/.miner-opted-in exists. The MCP server still boots and memories are still readable, but no background daemon spawns until the user opts in.
• Opt-in paths (all create the marker): /memem-mine, /memem-mine-history, --miner-opt-in, --mine-all, --miner-start.
• Auto-mine on install removed. The bootstrap auto-mine block added in v0.8.0 is gone. Install runs only the environment checks and execs the server.
• /memem welcome branches on miner state — shows the two mining options prominently when the user has not yet opted in.
• CLAUDE.md teaches Claude the two mining modes with trigger phrases ("start mining new sessions" vs "mine everything including history").

Migration

Existing users who already had the miner running: your miner will keep running for the current session, but on next Claude Code launch it won't auto-start unless you create the marker. Run /memem-mine once to opt in and preserve the old behaviour.

Upgrading

/plugin update memem