# Send SPIRIT State Sync to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "spirit",
    "name": "SPIRIT State Sync",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/gopinathnelluri/spirit",
    "canonicalUrl": "https://clawhub.ai/gopinathnelluri/spirit",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/spirit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spirit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/cron-setup.md",
      "scripts/spirit-sync-cron.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "spirit",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T09:27:58.027Z",
      "expiresAt": "2026-05-15T09:27:58.027Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spirit",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spirit",
        "contentDisposition": "attachment; filename=\"spirit-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "spirit"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/spirit"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/spirit",
    "downloadUrl": "https://openagent3.xyz/downloads/spirit",
    "agentUrl": "https://openagent3.xyz/skills/spirit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/spirit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/spirit/agent.md"
  }
}
```
## Documentation

### SPIRIT 🌌

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.

### New: OpenClaw Workspace Mode 🆕

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

### Requirements

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.

### Option A: OpenClaw Workspace Mode (Recommended)

# 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

### Option B: Standard Mode (Legacy)

# Files live in ~/.spirit/
spirit init --name="orion" --emoji="🌌"
spirit sync

### SPIRIT_SOURCE_DIR Environment Variable

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).

### What Gets Preserved

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"
  ]
}

### Option 1: SSH Keys (Recommended, no gh needed)

cd ~/.spirit
git remote add origin git@github.com:USER/REPO.git

### Option 2: GitHub CLI

gh auth login
git remote add origin https://github.com/USER/REPO.git

### Option 3: Git Credential Helper

git config credential.helper cache  # or 'store' for persistence
git remote add origin https://github.com/USER/REPO.git

### Security Checklist

☑️ 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

### Scheduled Sync

# Add to crontab
crontab -e

# Every 15 minutes
*/15 * * * * SPIRIT_SOURCE_DIR=/root/.openclaw/workspace /usr/local/bin/spirit sync 2>/dev/null

### Restore on New Machine

# 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

### Resources

SPIRIT: https://github.com/TheOrionAI/spirit
GitHub CLI: https://cli.github.com

License: MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: gopinathnelluri
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-08T09:27:58.027Z
- Expires at: 2026-05-15T09:27:58.027Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/spirit)
- [Send to Agent page](https://openagent3.xyz/skills/spirit/agent)
- [JSON manifest](https://openagent3.xyz/skills/spirit/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/spirit/agent.md)
- [Download page](https://openagent3.xyz/downloads/spirit)