spirit
by gopinathnelluri
Web & Frontend DevelopmentBrief
State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT)
Description
What This Skill Does
SPIRIT backs up AI agent state, including identity files, memory logs, and project files, to a private Git repository. It runs in standard mode from ~/.spirit/ or in workspace mode linked to an OpenClaw directory. Syncs can be triggered manually or on a cron schedule.
Stores agent state in plain Git, so identity and memory survive reinstalls and machine migrations without a proprietary cloud service.
When to Use It
- Backing up agent memory before switching machines
- Restoring a full agent identity on a new device
- Syncing conversation logs across multiple workspaces
- Scheduling automatic state snapshots every 15 minutes
- Migrating an agent's complete state to a new environment
Example Workflow
User asks: Set up SPIRIT to back up my agent's identity and memory to a private GitHub repo
- 1
Runs
spirit init --workspace=/root/.openclaw/workspace --name="orion" --emoji="🌌"to initialize workspace mode - 2
Adds the git remote with
git remote add origin git@github.com:USER/PRIVATE-REPO.git - 3
Reviews
.spirit-trackedto confirm which files are included in the sync - 4
Runs
spirit syncto push current state to the private repository - 5
Adds a crontab entry to run
spirit syncevery 15 minutes automatically
Agent identity, memory, and project files are versioned and pushed to the private GitHub repository, syncing on schedule
Requirements
- spirit CLI — install via: brew install TheOrionAI/tap/spirit
- Private Git repository (e.g., a private GitHub repo)
- GitHub account or SSH key configured for the remote
Installation
clawhub install gopinathnelluri/spiritRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.