← Back to Skills Marketplace
SPIRIT State Sync
by
Gopinath Nelluri
· GitHub ↗
· v1.1.0
772
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install spirit
Description
State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT). Preserves AI agent identity, memory, and projects to a private Git repository. NEW:...
Usage Guidance
This skill does what it says—it reads agent identity/memory files and syncs them to a Git repo—but check a few things before installing:
- Verify the origin of the 'spirit' binary: the registry recommends Homebrew (TheOrionAI/tap) but the docs also suggest running a curl | bash installer from theorionai.github.io. Inspect that install script and prefer package-managed installs if possible.
- Confirm you trust TheOrionAI tap/GitHub repo and audit the brew formula or install script source before running. Avoid piping unknown scripts to bash.
- Be aware that the tool will read your OpenClaw workspace and ~/.spirit files (sensitive identity/memory). The registry metadata did not declare these config paths—ensure you are comfortable with that access and that you point the tool only at intended directories.
- Use a private repository and SSH/gh auth as recommended; never embed tokens in URLs. Double-check your .spirit-tracked file before any sync.
- Scheduled syncs (cron, autobackup, OpenClaw cron wake) will repeatedly read and push workspace data. If you want a smaller blast radius, test in an isolated environment first and avoid enabling automated jobs until you’ve validated behavior.
If you want a higher-confidence assessment, provide the brew formula, the content of the theorionai.github.io/install.sh script, or the upstream GitHub repo for 'spirit' so those artifacts can be inspected for hidden behavior.
Capability Analysis
Type: OpenClaw Skill
Name: spirit
Version: 1.1.0
The OpenClaw AgentSkills bundle 'spirit' is designed to preserve AI agent identity and memory by syncing sensitive files (e.g., IDENTITY.md, memory/*.md) from the OpenClaw workspace to a user-configured private Git repository. This involves high-privilege operations including extensive file system access, network communication for Git operations, and persistence via cron jobs (SKILL.md, scripts/spirit-sync-cron.sh, references/cron-setup.md). While the stated purpose is legitimate backup, these capabilities inherently carry significant risk. Furthermore, the installation instructions for the 'spirit' CLI tool itself include a `curl -fsSL ... | bash` command (SKILL.md), which is a critical supply chain vulnerability and potential RCE risk, even if the skill bundle's immediate intent appears to be benign and includes security warnings.
Capability Assessment
Purpose & Capability
The skill is described as a tool that preserves agent identity/memory to a private Git repo. Declaring 'spirit' and 'git' as required binaries is coherent with that purpose. However, the SKILL.md expects access to the OpenClaw workspace path (/root/.openclaw/workspace) and ~/.spirit for tracked config; the registry metadata declares no required config paths. That mismatch between metadata and instructions is a sign of sloppy or incomplete declaration and should be confirmed.
Instruction Scope
The runtime instructions are primarily limited to running 'spirit init/sync', configuring a git remote, and optionally adding cron/OpenClaw scheduled jobs. These actions align with the stated purpose (reading identity/memory files and pushing them to a Git repo). Points to note: SKILL.md references and may read ~/.spirit/.spirit-tracked and workspace files (sensitive agent data), and it tells users to set SPIRIT_SOURCE_DIR (an env var not declared in the registry). There are no unexpected remote endpoints beyond GitHub remotes the user is asked to configure.
Install Mechanism
Registry includes a Homebrew install (TheOrionAI/tap/spirit) which is a reasonable/package-managed mechanism. SKILL.md also suggests running a curl | bash installer from theorionai.github.io for restoration. Having both a brew formula and an ad-hoc install script recommended is inconsistent and increases risk: curl|bash from a GitHub Pages domain is better than a random server but is still higher-risk than a package manager. Confirm which install method you trust and inspect the install script before running it.
Credentials
The skill declares no required environment variables or credentials, which is plausible because it expects the user to configure their git remote/auth (SSH or CLI). But SKILL.md relies on SPIRIT_SOURCE_DIR and paths under /root/.openclaw/workspace — this env var is used at runtime but was not declared. Asking the user to configure git credentials (SSH keys, gh login) is necessary for the feature, but the metadata should have documented expected paths/envs. The lack of declared config paths (despite explicit workspace usage) is a discrepancy.
Persistence & Privilege
The skill is not force-enabled (always: false) and can be invoked by the agent (normal). However, SKILL.md documents cron-based scheduled syncs, an autobackup daemon, and explicit OpenClaw cron integration that can wake the main agent to run syncs — these features give the skill a persistent/automated presence and increase the effective blast radius because they will repeatedly read the workspace and push data to a remote repo. This is coherent with the purpose but worth considering as an elevated privilege.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install spirit - After installation, invoke the skill by name or use
/spirit - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Add workspace mode with SPIRIT_SOURCE_DIR, symlinked config, optional gh requirement
v0.1.6
Add comprehensive tags for discoverability
v0.1.5
Full display name: State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT)
v0.1.4
Use full name: State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT)
v0.1.3
Security review: Homebrew-only, declared deps, no token-in-URL, review-before-sync warnings
v0.1.2
Add clear acronym definition: State Preservation & Identity Resurrection Infrastructure Tool
v0.1.1
Security fixes: secure auth patterns (gh CLI, credential helper), review-before-run installer guidance
v0.1.0
Initial release: AI agent state preservation with auto-sync support
Metadata
Frequently Asked Questions
What is SPIRIT State Sync?
State Preservation & Identity Resurrection Infrastructure Tool (SPIRIT). Preserves AI agent identity, memory, and projects to a private Git repository. NEW:... It is an AI Agent Skill for Claude Code / OpenClaw, with 772 downloads so far.
How do I install SPIRIT State Sync?
Run "/install spirit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SPIRIT State Sync free?
Yes, SPIRIT State Sync is completely free (open-source). You can download, install and use it at no cost.
Which platforms does SPIRIT State Sync support?
SPIRIT State Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SPIRIT State Sync?
It is built and maintained by Gopinath Nelluri (@gopinathnelluri); the current version is v1.1.0.
More Skills