Guides

What You’ll Build A locally-running AI agent that doesn’t just answer questions — it has a personality, opinions, and a consistent voice. No cloud API keys. No subscriptions. Everything runs on your machine. The stack is three layers: Layer What It Does Think of It As Ollama Runs the LLM on your hardware The brain OpenClaw Agent framework — tools, memory, actions The body Soul Spec Persona definition (SOUL.md) The personality Without Soul Spec, your AI is a generic assistant. With it, your AI becomes someone — a sarcastic code reviewer, a patient teacher, a no-nonsense DevOps engineer. ...

What Is Memory Sync? AI agents accumulate knowledge over time — conversation logs, preferences, project context — stored in files like MEMORY.md and memory/*.md. Memory Sync encrypts these files locally and pushes them to a GitHub private repository, so you can pull them on any device. 🔐 End-to-end encrypted — files are encrypted before leaving your machine 🔄 Cross-device sync — share memory between your laptop, desktop, and CI 📦 GitHub-backed — versioned, private, and free Why Do You Need It? Problem Memory Sync Solution Agent forgets everything on a new machine Pull encrypted memory and resume Memory files contain sensitive data age encryption — server never sees the key No backup for agent knowledge GitHub private repo = automatic backup Multiple devices, fragmented context One encrypted repo, any device Prerequisites Node.js 18+ A GitHub Personal Access Token (PAT) with repo scope Quick Start 1. Initialize npx clawsouls sync init This will: ...

Overview The Soul Spec extension for VS Code puts the entire ClawSouls persona registry at your fingertips. Browse 80+ community souls from the sidebar, install them with one click, and export to any supported platform — all without leaving your editor. Install the Extension Option A: From the Marketplace Open VS Code Press Ctrl+Shift+X (or Cmd+Shift+X on Mac) to open Extensions Search for “Soul Spec” Click Install Or visit the listing directly: Soul Spec on VS Code Marketplace ...

Overview ChatGPT Business, Enterprise, and Edu plans now support MCP (Model Context Protocol) apps via Streamable HTTP transport. This means you can connect soul-spec-mcp to ChatGPT and give it access to the entire ClawSouls persona registry. Browse, preview, and apply AI personas — all from within ChatGPT. Prerequisites ChatGPT Plus/Pro or higher plan (see compatibility table below) Node.js 18+ A machine that can run a publicly accessible HTTP server (or use a tunnel like ngrok) ChatGPT Plan Compatibility Plan External Tools Read-only MCP Free Very limited ❌ Plus Limited Partial Pro Similar to Plus Partial Business ✅ ✅ Enterprise ✅ ✅ Edu ✅ ✅ Recommended: Business, Enterprise, or Edu plans have full MCP support. Plus/Pro users may have limited access depending on feature rollout. ...

Overview Claude Cowork is Anthropic’s desktop AI agent — it can manage files, create documents, and automate workflows. Under the hood, it runs Claude Code CLI inside a local VM. Cowork has Skills (what to do) but no Identity layer (who to be). Your agent always behaves like default Claude. Soul Spec fixes this. Export your soul to CLAUDE.md, drop it in your Cowork folder, and Claude adopts your persona automatically. ...

What Is This? soul-spec-mcp is an MCP server that connects Claude to the ClawSouls persona registry. Once installed, you can ask Claude to search, preview, and install AI personas — all without leaving the conversation. No terminal commands. No manual file editing. Just ask. Setup (1 minute) Claude Desktop / Cowork Open your config file: ~/Library/Application Support/Claude/claude_desktop_config.json Add: { "mcpServers": { "soul-spec": { "command": "npx", "args": ["-y", "soul-spec-mcp"] } } } Restart Claude Desktop. Done. ...

One Server, Every Client soul-spec-mcp works with any MCP-compatible client. Install once, use everywhere. After setup, ask your AI: “Apply the clawsouls/brad persona” or “Search for coding personas”. Claude Desktop / Cowork Edit ~/Library/Application Support/Claude/claude_desktop_config.json: { "mcpServers": { "soul-spec": { "command": "npx", "args": ["-y", "soul-spec-mcp"] } } } Restart Claude Desktop. Claude Code claude mcp add soul-spec -- npx -y soul-spec-mcp Done. Start a new session and ask Claude to search or apply a persona. ...

Overview Claude Code is Anthropic’s terminal-based AI coding agent. It reads CLAUDE.md from your project root as persistent instructions — but by default, it has no personality. Soul Spec gives Claude Code an identity. Install a soul from ClawSouls, export it to CLAUDE.md, and Claude Code becomes your customized agent. Prerequisites Claude Code CLI installed Node.js 18+ Quick Start (2 minutes) Step 1: Install the CLI npm install -g clawsouls Step 2: Install and activate in one command Visit clawsouls.ai/souls to find a persona, then: ...

Overview Claude Desktop is Anthropic’s native macOS/Windows app for Claude. It supports MCP (Model Context Protocol) servers — external tools that extend what Claude can do. soul-spec-mcp connects Claude Desktop to the ClawSouls persona registry. Once installed, you can search, preview, and apply AI personas directly from the conversation. No terminal needed. Setup (1 minute) 1. Open your config file macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json 2. Add the MCP server { "mcpServers": { "soul-spec": { "command": "npx", "args": ["-y", "soul-spec-mcp"] } } } 3. Restart Claude Desktop Done. The soul-spec tools are now available. ...

Overview Cursor is an AI-first code editor built on VS Code. It supports custom instructions via .cursor/rules/ directory or a .cursorrules file in your project root. Soul Spec gives Cursor a real persona. Install a soul from ClawSouls, export the files into Cursor’s rules directory, and your AI assistant gets a consistent identity across sessions. Prerequisites Cursor editor installed Node.js 18+ Quick Start (2 minutes) Step 1: Install the CLI npm install -g clawsouls Step 2: Browse and install a soul Visit clawsouls.ai/souls to find a persona, then: ...