{
  "schemaVersion": "1.0",
  "item": {
    "slug": "chaos-mind",
    "name": "Chaos Mind",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hargabyte/chaos-mind",
    "canonicalUrl": "https://clawhub.ai/hargabyte/chaos-mind",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/chaos-mind",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=chaos-mind",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "DEPLOYMENT_CHECKLIST.md",
      "INSTALL_NOTES.md",
      "README.md",
      "RELEASE_INSTRUCTIONS.md",
      "RELEASE_SUMMARY.md",
      "SECURITY.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/chaos-mind"
    },
    "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/chaos-mind",
    "agentPageUrl": "https://openagent3.xyz/skills/chaos-mind/agent",
    "manifestUrl": "https://openagent3.xyz/skills/chaos-mind/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/chaos-mind/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "CHAOS Memory",
        "body": "Context-aware Hierarchical Autonomous Observation System\n\nHybrid search memory for AI agents with 4 retrieval signals:\n\nBM25 - Keyword matching\nVector - Semantic similarity\nGraph - Relationship bonuses\nHeat - Access patterns + priority"
      },
      {
        "title": "🤖 For AI Agents: How to Use This Tool",
        "body": "First time? Run this to see the complete reference:\n\nchaos-cli --help\n\nQuick workflow:\n\nBefore a task: chaos-cli search \"keywords\" --mode index --limit 10\nDuring a task: chaos-cli store \"important fact\" --category decision --priority 0.9\nAfter a task: chaos-cli list 10\n\nToken savings: Use --mode index for 90% token savings (~75 tokens/result)\n\nMore help: Run chaos help-agents for the AI-optimized reference guide."
      },
      {
        "title": "Quick Start",
        "body": "After installation, use chaos-cli:\n\n# Search memories\nchaos-cli search \"pricing decisions\" --limit 5\n\n# Store a memory\nchaos-cli store \"Enterprise tier: $99/month\" --category decision\n\n# List recent\nchaos-cli list 10"
      },
      {
        "title": "Search Memories",
        "body": "Quick search (summary mode):\n\nchaos-cli search \"architecture patterns\" --mode summary --limit 5\n\nFast scan (index mode, 90% token savings):\n\nchaos-cli search \"team decisions\" --mode index --limit 10\n\nFull detail:\n\nchaos-cli search \"model selection\" --mode full --limit 3\n\nModes:\n\nModeTokens/ResultUse Caseindex~75Quick scan, many resultssummary~250Balanced (default)full~750Deep dive"
      },
      {
        "title": "Store Memory",
        "body": "# Decision\nchaos-cli store \"Qwen3-1.7B is default model\" --category decision --priority 0.9\n\n# Core fact\nchaos-cli store \"Database runs on port 3307\" --category core --priority 0.7\n\n# Research finding\nchaos-cli store \"43x speedup with think=false\" --category research --priority 0.8\n\nCategories: decision, core, semantic, research\n\nPriority: 0.0-1.0 (higher = more important)"
      },
      {
        "title": "Get by ID",
        "body": "chaos-cli get <memory-id>"
      },
      {
        "title": "List Recent",
        "body": "chaos-cli list        # Default 10\nchaos-cli list 20     # Show 20"
      },
      {
        "title": "Auto-Capture (Optional - Opt-In Only)",
        "body": "⚠️ DISABLED BY DEFAULT for privacy.\n\nTo enable auto-capture:\n\nReview privacy implications - reads your session transcripts\nEdit config: nano ~/.chaos/config/consolidator.yaml\nSet: auto_capture.enabled: true\nConfigure paths: Add your session directories to auto_capture.sources\nInstall Ollama: https://ollama.com (if not already installed)\nPull model: ollama pull qwen3:1.7b\nTest: chaos-consolidator --auto-capture --once\n\nWhat it extracts: Decisions, facts, insights\nWhat it skips: Greetings, filler, acknowledgments\nWhere it runs: 100% local (your machine, no external APIs)\nSpeed: 2.6s per message (~42s per 16-message session)\n\nPrivacy: Only processes files you explicitly configure. See SECURITY.md for details."
      },
      {
        "title": "🔗 Enhanced Capabilities",
        "body": "CHAOS Memory integrates with other tools for deeper intelligence:"
      },
      {
        "title": "Cortex (cx) - Semantic Code Anchoring",
        "body": "What it does: Anchors memories to specific code locations and files\n\nWhy use it: Memories become context-aware - \"this decision affects Auth.tsx lines 45-67\"\n\nHow it works:\n\nCHAOS detects if cx is available at startup\nAutomatically creates semantic links: memory → code location\nSearch results include related code snippets\n\nInstall Cortex:\n\n# Cortex is a separate tool\n# Install from: https://github.com/hargabyte/cortex\n\nExample:\n\n# Without Cortex\nchaos-cli search \"auth flow\"\n→ \"Changed auth to use JWT tokens\"\n\n# With Cortex\nchaos-cli search \"auth flow\"\n→ \"Changed auth to use JWT tokens\"\n→ 📍 Auth.tsx:45-67, middleware/auth.js:12"
      },
      {
        "title": "Beads - Task Relationship Tracking",
        "body": "What it does: Links memories to tasks and issues\n\nWhy use it: Track which memories led to which tasks, decisions to implementations\n\nHow it works:\n\nCHAOS detects if beads or beads-rust is available\nCreates bidirectional links: memory ↔ task\nMemories can reference issue IDs automatically\n\nInstall Beads:\n\n# Beads is a separate task management tool\n# Install from: https://github.com/hargabyte/beads\n\nExample:\n\n# Store memory with task reference\nchaos-cli store \"Need to refactor auth\" --category decision --task AUTH-123\n\n# Search shows related tasks\nchaos-cli search \"auth refactor\"\n→ \"Need to refactor auth\"\n→ 📋 Task: AUTH-123 (In Progress)"
      },
      {
        "title": "Combined Power",
        "body": "When all three tools work together:\n\nchaos-cli search \"performance optimization\"\n→ Memory: \"Added Redis caching layer\"\n→ 📍 Code: cache/redis.js:34-89\n→ 📋 Task: PERF-042 (Completed)\n→ 🔗 Related: 3 other memories, 2 code files, 1 PR\n\nStatus Detection:\n\nCortex: Detected automatically on startup (logs [OPT] Cortex Engine: FOUND)\nBeads: Detected automatically on startup (logs [OPT] Beads Task Manager: FOUND)\nView status: Check the startup logs when running chaos-mcp"
      },
      {
        "title": "Configuration",
        "body": "Default config location: ~/.chaos/config/consolidator.yaml\n\n# Auto-capture is DISABLED by default\nauto_capture:\n  enabled: false  # Change to true after configuring paths\n  sources: []     # Add your session paths here\n  \n# Example (uncomment after reviewing):\n# sources:\n#   - ~/.openclaw-*/agents/*/sessions/*.jsonl\n\nqwen:\n  model: qwen3:1.7b  # Locked default\n\nchaos:\n  mode: mcp\n  mcp:\n    env:\n      CHAOS_DB_PATH: \"~/.chaos/db\""
      },
      {
        "title": "Environment Variables",
        "body": "VariableDefaultDescriptionCHAOS_HOME~/.chaosInstallation directoryCHAOS_DB_PORT3307Database portCHAOS_MODELqwen3:1.7bExtraction model"
      },
      {
        "title": "Requirements",
        "body": "Dolt - Version-controlled database\nOllama - Local LLM inference (for auto-capture)\nGo 1.21+ - To build from source (optional)\n\nThe install script handles dependencies automatically."
      },
      {
        "title": "Troubleshooting",
        "body": "Command not found:\n\nexport PATH=\"$HOME/.chaos/bin:$PATH\"\n\nDatabase error:\n\ncd ~/.chaos/db && dolt sql-server --port 3307 &\n\nNo results:\n\nchaos-cli list  # Check if memories exist"
      },
      {
        "title": "Security & Privacy",
        "body": "Data Storage: All memories stored locally on your machine (~/.chaos/db)\n\nNo cloud sync or external transmission\nYour data never leaves your computer\nDatabase is version-controlled (Dolt) for auditability\n\nAuto-Capture (Opt-In):\n\nDisabled by default - you must explicitly enable and configure\nRequires manual configuration of session paths in ~/.chaos/config.yaml\nOnly processes files you explicitly specify in auto_capture.sources\nRuns locally using your own Ollama instance (no external API calls)\n\nPermissions:\n\nRead: Session transcript files (only paths you configure)\nWrite: Local database (~/.chaos/db)\nNetwork: None (all processing is local)\n\nControl:\n\n# View what auto-capture will process (dry-run)\nchaos-consolidator --auto-capture --once --dry-run\n\n# Disable auto-capture\n# Edit ~/.chaos/config.yaml:\n# auto_capture:\n#   enabled: false\n\n# Or simply don't configure session paths\n\nTransparency:\n\nInstall script source: Included in repo (install.sh)\nAll binaries built via GitHub Actions (reproducible)\nDatabase is plain Dolt (inspect with dolt sql)"
      },
      {
        "title": "Links",
        "body": "GitHub: https://github.com/hargabyte/Chaos-mind\nDocs: https://github.com/hargabyte/Chaos-mind/blob/main/README.md\nIssues: https://github.com/hargabyte/Chaos-mind/issues\n\nVersion 1.0.0 | Created by HSA Team"
      }
    ],
    "body": "CHAOS Memory\n\nContext-aware Hierarchical Autonomous Observation System\n\nHybrid search memory for AI agents with 4 retrieval signals:\n\nBM25 - Keyword matching\nVector - Semantic similarity\nGraph - Relationship bonuses\nHeat - Access patterns + priority\n🤖 For AI Agents: How to Use This Tool\n\nFirst time? Run this to see the complete reference:\n\nchaos-cli --help\n\n\nQuick workflow:\n\nBefore a task: chaos-cli search \"keywords\" --mode index --limit 10\nDuring a task: chaos-cli store \"important fact\" --category decision --priority 0.9\nAfter a task: chaos-cli list 10\n\nToken savings: Use --mode index for 90% token savings (~75 tokens/result)\n\nMore help: Run chaos help-agents for the AI-optimized reference guide.\n\nQuick Start\n\nAfter installation, use chaos-cli:\n\n# Search memories\nchaos-cli search \"pricing decisions\" --limit 5\n\n# Store a memory\nchaos-cli store \"Enterprise tier: $99/month\" --category decision\n\n# List recent\nchaos-cli list 10\n\nSearch Memories\n\nQuick search (summary mode):\n\nchaos-cli search \"architecture patterns\" --mode summary --limit 5\n\n\nFast scan (index mode, 90% token savings):\n\nchaos-cli search \"team decisions\" --mode index --limit 10\n\n\nFull detail:\n\nchaos-cli search \"model selection\" --mode full --limit 3\n\n\nModes:\n\nMode\tTokens/Result\tUse Case\nindex\t~75\tQuick scan, many results\nsummary\t~250\tBalanced (default)\nfull\t~750\tDeep dive\nStore Memory\n# Decision\nchaos-cli store \"Qwen3-1.7B is default model\" --category decision --priority 0.9\n\n# Core fact\nchaos-cli store \"Database runs on port 3307\" --category core --priority 0.7\n\n# Research finding\nchaos-cli store \"43x speedup with think=false\" --category research --priority 0.8\n\n\nCategories: decision, core, semantic, research\n\nPriority: 0.0-1.0 (higher = more important)\n\nGet by ID\nchaos-cli get <memory-id>\n\nList Recent\nchaos-cli list        # Default 10\nchaos-cli list 20     # Show 20\n\nAuto-Capture (Optional - Opt-In Only)\n\n⚠️ DISABLED BY DEFAULT for privacy.\n\nTo enable auto-capture:\n\nReview privacy implications - reads your session transcripts\nEdit config: nano ~/.chaos/config/consolidator.yaml\nSet: auto_capture.enabled: true\nConfigure paths: Add your session directories to auto_capture.sources\nInstall Ollama: https://ollama.com (if not already installed)\nPull model: ollama pull qwen3:1.7b\nTest: chaos-consolidator --auto-capture --once\n\nWhat it extracts: Decisions, facts, insights\nWhat it skips: Greetings, filler, acknowledgments\nWhere it runs: 100% local (your machine, no external APIs)\nSpeed: 2.6s per message (~42s per 16-message session)\n\nPrivacy: Only processes files you explicitly configure. See SECURITY.md for details.\n\n🔗 Enhanced Capabilities\n\nCHAOS Memory integrates with other tools for deeper intelligence:\n\nCortex (cx) - Semantic Code Anchoring\n\nWhat it does: Anchors memories to specific code locations and files\n\nWhy use it: Memories become context-aware - \"this decision affects Auth.tsx lines 45-67\"\n\nHow it works:\n\nCHAOS detects if cx is available at startup\nAutomatically creates semantic links: memory → code location\nSearch results include related code snippets\n\nInstall Cortex:\n\n# Cortex is a separate tool\n# Install from: https://github.com/hargabyte/cortex\n\n\nExample:\n\n# Without Cortex\nchaos-cli search \"auth flow\"\n→ \"Changed auth to use JWT tokens\"\n\n# With Cortex\nchaos-cli search \"auth flow\"\n→ \"Changed auth to use JWT tokens\"\n→ 📍 Auth.tsx:45-67, middleware/auth.js:12\n\nBeads - Task Relationship Tracking\n\nWhat it does: Links memories to tasks and issues\n\nWhy use it: Track which memories led to which tasks, decisions to implementations\n\nHow it works:\n\nCHAOS detects if beads or beads-rust is available\nCreates bidirectional links: memory ↔ task\nMemories can reference issue IDs automatically\n\nInstall Beads:\n\n# Beads is a separate task management tool\n# Install from: https://github.com/hargabyte/beads\n\n\nExample:\n\n# Store memory with task reference\nchaos-cli store \"Need to refactor auth\" --category decision --task AUTH-123\n\n# Search shows related tasks\nchaos-cli search \"auth refactor\"\n→ \"Need to refactor auth\"\n→ 📋 Task: AUTH-123 (In Progress)\n\nCombined Power\n\nWhen all three tools work together:\n\nchaos-cli search \"performance optimization\"\n→ Memory: \"Added Redis caching layer\"\n→ 📍 Code: cache/redis.js:34-89\n→ 📋 Task: PERF-042 (Completed)\n→ 🔗 Related: 3 other memories, 2 code files, 1 PR\n\n\nStatus Detection:\n\nCortex: Detected automatically on startup (logs [OPT] Cortex Engine: FOUND)\nBeads: Detected automatically on startup (logs [OPT] Beads Task Manager: FOUND)\nView status: Check the startup logs when running chaos-mcp\nConfiguration\n\nDefault config location: ~/.chaos/config/consolidator.yaml\n\n# Auto-capture is DISABLED by default\nauto_capture:\n  enabled: false  # Change to true after configuring paths\n  sources: []     # Add your session paths here\n  \n# Example (uncomment after reviewing):\n# sources:\n#   - ~/.openclaw-*/agents/*/sessions/*.jsonl\n\nqwen:\n  model: qwen3:1.7b  # Locked default\n\nchaos:\n  mode: mcp\n  mcp:\n    env:\n      CHAOS_DB_PATH: \"~/.chaos/db\"\n\nEnvironment Variables\nVariable\tDefault\tDescription\nCHAOS_HOME\t~/.chaos\tInstallation directory\nCHAOS_DB_PORT\t3307\tDatabase port\nCHAOS_MODEL\tqwen3:1.7b\tExtraction model\nRequirements\nDolt - Version-controlled database\nOllama - Local LLM inference (for auto-capture)\nGo 1.21+ - To build from source (optional)\n\nThe install script handles dependencies automatically.\n\nTroubleshooting\n\nCommand not found:\n\nexport PATH=\"$HOME/.chaos/bin:$PATH\"\n\n\nDatabase error:\n\ncd ~/.chaos/db && dolt sql-server --port 3307 &\n\n\nNo results:\n\nchaos-cli list  # Check if memories exist\n\nSecurity & Privacy\n\nData Storage: All memories stored locally on your machine (~/.chaos/db)\n\nNo cloud sync or external transmission\nYour data never leaves your computer\nDatabase is version-controlled (Dolt) for auditability\n\nAuto-Capture (Opt-In):\n\nDisabled by default - you must explicitly enable and configure\nRequires manual configuration of session paths in ~/.chaos/config.yaml\nOnly processes files you explicitly specify in auto_capture.sources\nRuns locally using your own Ollama instance (no external API calls)\n\nPermissions:\n\nRead: Session transcript files (only paths you configure)\nWrite: Local database (~/.chaos/db)\nNetwork: None (all processing is local)\n\nControl:\n\n# View what auto-capture will process (dry-run)\nchaos-consolidator --auto-capture --once --dry-run\n\n# Disable auto-capture\n# Edit ~/.chaos/config.yaml:\n# auto_capture:\n#   enabled: false\n\n# Or simply don't configure session paths\n\n\nTransparency:\n\nInstall script source: Included in repo (install.sh)\nAll binaries built via GitHub Actions (reproducible)\nDatabase is plain Dolt (inspect with dolt sql)\nLinks\nGitHub: https://github.com/hargabyte/Chaos-mind\nDocs: https://github.com/hargabyte/Chaos-mind/blob/main/README.md\nIssues: https://github.com/hargabyte/Chaos-mind/issues\n\nVersion 1.0.0 | Created by HSA Team"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/hargabyte/chaos-mind",
    "publisherUrl": "https://clawhub.ai/hargabyte/chaos-mind",
    "owner": "hargabyte",
    "version": "0.1.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/chaos-mind",
    "downloadUrl": "https://openagent3.xyz/downloads/chaos-mind",
    "agentUrl": "https://openagent3.xyz/skills/chaos-mind/agent",
    "manifestUrl": "https://openagent3.xyz/skills/chaos-mind/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/chaos-mind/agent.md"
  }
}