Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT). Preserves AI agent identity, memory, and projects to a private Git repository. NEW:...
State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT). Preserves AI agent identity, memory, and projects to a private Git repository. NEW:...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
State Preservation & Identity Resurrection Infrastructure Tool Preserves AI agent identity, memory, and projects in a portable Git repository. Your AI's spirit, always preserved. Death. Migration. Multi-device. Always you.
SPIRIT can now link directly to your OpenClaw workspace: # Initialize with workspace mode spirit init --workspace=/root/.openclaw/workspace --name="orion" --emoji="๐" # All your identity/memory files stay in workspace # Only .spirit-tracked config is symlinked to ~/.spirit/ Benefits: โ Edit .spirit-tracked config directly in workspace โ All identity/memory files in one place โ Sync with SPIRIT_SOURCE_DIR=/root/.openclaw/workspace spirit sync
ToolPurposeRequired?InstallgitVersion controlRequiredBuilt-inspiritThis toolRequiredbrew install TheOrionAI/tap/spiritghGitHub CLIOptional*brew install gh *Only needed if you prefer GitHub CLI auth. SSH keys work without gh.
# 1. Initialize with your OpenClaw workspace spirit init --workspace=/root/.openclaw/workspace --name="orion" --emoji="๐" # 2. Edit what gets synced cat /root/.openclaw/workspace/.spirit-tracked # 3. Configure git remote cd ~/.spirit git remote add origin git@github.com:USER/PRIVATE-REPO.git # 4. Sync export SPIRIT_SOURCE_DIR=/root/.openclaw/workspace spirit sync
# Files live in ~/.spirit/ spirit init --name="orion" --emoji="๐" spirit sync
When set, SPIRIT reads files from this directory instead of ~/.spirit/: # One-time sync SPIRIT_SOURCE_DIR=/path/to/workspace spirit sync # Or export for session export SPIRIT_SOURCE_DIR=/path/to/workspace spirit sync The .spirit-tracked config is still read from ~/.spirit/ (which may be a symlink to your workspace).
With OpenClaw workspace mode, these files sync from your workspace: FileContentsIDENTITY.mdYour agent's identitySOUL.mdBehavior/personality guidelinesAGENTS.mdAgent configurationUSER.mdUser preferencesmemory/*.mdDaily conversation logsprojects/*.mdActive project files.spirit-trackedConfig: What to sync (edit this!) Default .spirit-tracked: { "version": "1.0.0", "files": [ "IDENTITY.md", "SOUL.md", "AGENTS.md", "USER.md", "memory/*.md", "projects/*.md" ] }
cd ~/.spirit git remote add origin git@github.com:USER/REPO.git
gh auth login git remote add origin https://github.com/USER/REPO.git
git config credential.helper cache # or 'store' for persistence git remote add origin https://github.com/USER/REPO.git
โ๏ธ Repository: Always PRIVATE โ state files contain identity and memory โ๏ธ Authentication: Use SSH keys or gh auth login โ never tokens in URLs โ๏ธ Review: Check cat ~/.spirit/.spirit-tracked before sync โ๏ธ Test: Verify first sync in isolation Never use: โ https://TOKEN@github.com/... in remote URL โ Tokens in shell history or process lists
# Add to crontab crontab -e # Every 15 minutes */15 * * * * SPIRIT_SOURCE_DIR=/root/.openclaw/workspace /usr/local/bin/spirit sync 2>/dev/null
# Install SPIRIT curl -fsSL https://theorionai.github.io/spirit/install.sh | bash # Clone your state git clone git@github.com:USER/REPO.git ~/.spirit # If using workspace mode, set source directory export SPIRIT_SOURCE_DIR=/your/workspace/path
SPIRIT: https://github.com/TheOrionAI/spirit GitHub CLI: https://cli.github.com License: MIT
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.