{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/spirit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spirit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/cron-setup.md",
      "scripts/spirit-sync-cron.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/spirit",
    "agentPageUrl": "https://openagent3.xyz/skills/spirit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/spirit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/spirit/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "SPIRIT 🌌",
        "body": "State Preservation & Identity Resurrection Infrastructure Tool\n\nPreserves AI agent identity, memory, and projects in a portable Git repository.\nYour AI's spirit, always preserved. Death. Migration. Multi-device. Always you."
      },
      {
        "title": "New: OpenClaw Workspace Mode 🆕",
        "body": "SPIRIT can now link directly to your OpenClaw workspace:\n\n# Initialize with workspace mode\nspirit init --workspace=/root/.openclaw/workspace --name=\"orion\" --emoji=\"🌌\"\n\n# All your identity/memory files stay in workspace\n# Only .spirit-tracked config is symlinked to ~/.spirit/\n\nBenefits:\n\n✅ Edit .spirit-tracked config directly in workspace\n✅ All identity/memory files in one place\n✅ Sync with SPIRIT_SOURCE_DIR=/root/.openclaw/workspace spirit sync"
      },
      {
        "title": "Requirements",
        "body": "ToolPurposeRequired?InstallgitVersion controlRequiredBuilt-inspiritThis toolRequiredbrew install TheOrionAI/tap/spiritghGitHub CLIOptional*brew install gh\n\n*Only needed if you prefer GitHub CLI auth. SSH keys work without gh."
      },
      {
        "title": "Option A: OpenClaw Workspace Mode (Recommended)",
        "body": "# 1. Initialize with your OpenClaw workspace\nspirit init --workspace=/root/.openclaw/workspace --name=\"orion\" --emoji=\"🌌\"\n\n# 2. Edit what gets synced\ncat /root/.openclaw/workspace/.spirit-tracked\n\n# 3. Configure git remote\ncd ~/.spirit\ngit remote add origin git@github.com:USER/PRIVATE-REPO.git\n\n# 4. Sync\nexport SPIRIT_SOURCE_DIR=/root/.openclaw/workspace\nspirit sync"
      },
      {
        "title": "Option B: Standard Mode (Legacy)",
        "body": "# Files live in ~/.spirit/\nspirit init --name=\"orion\" --emoji=\"🌌\"\nspirit sync"
      },
      {
        "title": "SPIRIT_SOURCE_DIR Environment Variable",
        "body": "When set, SPIRIT reads files from this directory instead of ~/.spirit/:\n\n# One-time sync\nSPIRIT_SOURCE_DIR=/path/to/workspace spirit sync\n\n# Or export for session\nexport SPIRIT_SOURCE_DIR=/path/to/workspace\nspirit sync\n\nThe .spirit-tracked config is still read from ~/.spirit/ (which may be a symlink to your workspace)."
      },
      {
        "title": "What Gets Preserved",
        "body": "With OpenClaw workspace mode, these files sync from your workspace:\n\nFileContentsIDENTITY.mdYour agent's identitySOUL.mdBehavior/personality guidelinesAGENTS.mdAgent configurationUSER.mdUser preferencesmemory/*.mdDaily conversation logsprojects/*.mdActive project files.spirit-trackedConfig: What to sync (edit this!)\n\nDefault .spirit-tracked:\n\n{\n  \"version\": \"1.0.0\",\n  \"files\": [\n    \"IDENTITY.md\",\n    \"SOUL.md\",\n    \"AGENTS.md\",\n    \"USER.md\",\n    \"memory/*.md\",\n    \"projects/*.md\"\n  ]\n}"
      },
      {
        "title": "Option 1: SSH Keys (Recommended, no gh needed)",
        "body": "cd ~/.spirit\ngit remote add origin git@github.com:USER/REPO.git"
      },
      {
        "title": "Option 2: GitHub CLI",
        "body": "gh auth login\ngit remote add origin https://github.com/USER/REPO.git"
      },
      {
        "title": "Option 3: Git Credential Helper",
        "body": "git config credential.helper cache  # or 'store' for persistence\ngit remote add origin https://github.com/USER/REPO.git"
      },
      {
        "title": "Security Checklist",
        "body": "☑️ Repository: Always PRIVATE — state files contain identity and memory\n☑️ Authentication: Use SSH keys or gh auth login — never tokens in URLs\n☑️ Review: Check cat ~/.spirit/.spirit-tracked before sync\n☑️ Test: Verify first sync in isolation\n\nNever use:\n\n❌ https://TOKEN@github.com/... in remote URL\n❌ Tokens in shell history or process lists"
      },
      {
        "title": "Scheduled Sync",
        "body": "# Add to crontab\ncrontab -e\n\n# Every 15 minutes\n*/15 * * * * SPIRIT_SOURCE_DIR=/root/.openclaw/workspace /usr/local/bin/spirit sync 2>/dev/null"
      },
      {
        "title": "Restore on New Machine",
        "body": "# Install SPIRIT\ncurl -fsSL https://theorionai.github.io/spirit/install.sh | bash\n\n# Clone your state\ngit clone git@github.com:USER/REPO.git ~/.spirit\n\n# If using workspace mode, set source directory\nexport SPIRIT_SOURCE_DIR=/your/workspace/path"
      },
      {
        "title": "Resources",
        "body": "SPIRIT: https://github.com/TheOrionAI/spirit\nGitHub CLI: https://cli.github.com\n\nLicense: MIT"
      }
    ],
    "body": "SPIRIT 🌌\n\nState Preservation & Identity Resurrection Infrastructure Tool\n\nPreserves AI agent identity, memory, and projects in a portable Git repository. Your AI's spirit, always preserved. Death. Migration. Multi-device. Always you.\n\nNew: OpenClaw Workspace Mode 🆕\n\nSPIRIT can now link directly to your OpenClaw workspace:\n\n# Initialize with workspace mode\nspirit init --workspace=/root/.openclaw/workspace --name=\"orion\" --emoji=\"🌌\"\n\n# All your identity/memory files stay in workspace\n# Only .spirit-tracked config is symlinked to ~/.spirit/\n\n\nBenefits:\n\n✅ Edit .spirit-tracked config directly in workspace\n✅ All identity/memory files in one place\n✅ Sync with SPIRIT_SOURCE_DIR=/root/.openclaw/workspace spirit sync\nRequirements\nTool\tPurpose\tRequired?\tInstall\ngit\tVersion control\tRequired\tBuilt-in\nspirit\tThis tool\tRequired\tbrew install TheOrionAI/tap/spirit\ngh\tGitHub CLI\tOptional*\tbrew install gh\n\n*Only needed if you prefer GitHub CLI auth. SSH keys work without gh.\n\nQuick Start\nOption A: OpenClaw Workspace Mode (Recommended)\n# 1. Initialize with your OpenClaw workspace\nspirit init --workspace=/root/.openclaw/workspace --name=\"orion\" --emoji=\"🌌\"\n\n# 2. Edit what gets synced\ncat /root/.openclaw/workspace/.spirit-tracked\n\n# 3. Configure git remote\ncd ~/.spirit\ngit remote add origin git@github.com:USER/PRIVATE-REPO.git\n\n# 4. Sync\nexport SPIRIT_SOURCE_DIR=/root/.openclaw/workspace\nspirit sync\n\nOption B: Standard Mode (Legacy)\n# Files live in ~/.spirit/\nspirit init --name=\"orion\" --emoji=\"🌌\"\nspirit sync\n\nSPIRIT_SOURCE_DIR Environment Variable\n\nWhen set, SPIRIT reads files from this directory instead of ~/.spirit/:\n\n# One-time sync\nSPIRIT_SOURCE_DIR=/path/to/workspace spirit sync\n\n# Or export for session\nexport SPIRIT_SOURCE_DIR=/path/to/workspace\nspirit sync\n\n\nThe .spirit-tracked config is still read from ~/.spirit/ (which may be a symlink to your workspace).\n\nWhat Gets Preserved\n\nWith OpenClaw workspace mode, these files sync from your workspace:\n\nFile\tContents\nIDENTITY.md\tYour agent's identity\nSOUL.md\tBehavior/personality guidelines\nAGENTS.md\tAgent configuration\nUSER.md\tUser preferences\nmemory/*.md\tDaily conversation logs\nprojects/*.md\tActive project files\n.spirit-tracked\tConfig: What to sync (edit this!)\n\nDefault .spirit-tracked:\n\n{\n  \"version\": \"1.0.0\",\n  \"files\": [\n    \"IDENTITY.md\",\n    \"SOUL.md\",\n    \"AGENTS.md\",\n    \"USER.md\",\n    \"memory/*.md\",\n    \"projects/*.md\"\n  ]\n}\n\nAuthentication Options\nOption 1: SSH Keys (Recommended, no gh needed)\ncd ~/.spirit\ngit remote add origin git@github.com:USER/REPO.git\n\nOption 2: GitHub CLI\ngh auth login\ngit remote add origin https://github.com/USER/REPO.git\n\nOption 3: Git Credential Helper\ngit config credential.helper cache  # or 'store' for persistence\ngit remote add origin https://github.com/USER/REPO.git\n\nSecurity Checklist\n\n☑️ 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\n\nNever use:\n\n❌ https://TOKEN@github.com/... in remote URL\n❌ Tokens in shell history or process lists\nScheduled Sync\n# Add to crontab\ncrontab -e\n\n# Every 15 minutes\n*/15 * * * * SPIRIT_SOURCE_DIR=/root/.openclaw/workspace /usr/local/bin/spirit sync 2>/dev/null\n\nRestore on New Machine\n# Install SPIRIT\ncurl -fsSL https://theorionai.github.io/spirit/install.sh | bash\n\n# Clone your state\ngit clone git@github.com:USER/REPO.git ~/.spirit\n\n# If using workspace mode, set source directory\nexport SPIRIT_SOURCE_DIR=/your/workspace/path\n\nResources\nSPIRIT: https://github.com/TheOrionAI/spirit\nGitHub CLI: https://cli.github.com\n\nLicense: MIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/gopinathnelluri/spirit",
    "publisherUrl": "https://clawhub.ai/gopinathnelluri/spirit",
    "owner": "gopinathnelluri",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}