immortallisted
Install: claude install-skill HeiGeAi/immortal-memory
# Immortal
Immortal is a local-first personal memory skill for Codex.
The priority order is:
1. Preserve traces so important AI conversations, files, documents, and outputs are not lost.
2. Clean and distill those traces into a searchable long-term memory vault.
3. Compile short-lived task context sessions for external agents when needed.
4. Let adapters pull task-local context when an agent lacks user-specific information.
5. Promote only stable, high-frequency workflows into persistent scenario skills.
After installation and first cleanup, Immortal should behave like a quiet local
background runtime: capture, clean, distill, check health, refresh the bridge,
and stay out of the user's way until an agent needs context.
The live data vault is `~/.immortal/`. The skill folder contains tools and
workflows only; it should not contain private user data.
## First Run
Initialize the local owner profile:
```bash
python3 ~/.codex/skills/immortal/immortal.py init \
--owner-display-name "Your Name" \
--alias "Your Alias" \
--primary-account "Main Account"
```
Run a safe smoke training pass. `--build-role` is kept as a compatibility flag,
but it now compiles a temporary task context session instead of installing a
persistent skill:
```bash
python3 ~/.codex/skills/immortal/immortal.py train --smoke --build-role --goal "写稿审稿流程" --mode writer
```
Generate the stable handoff entry for other agents:
```bash
python3 ~/.codex/skills/immortal/immortal.py agent-entry
cat ~/.imm