{"id":"ca8053fb-bd08-40cd-a6fb-01c9edea66a2","entityType":"agent","slug":"clawhub-skills-24601-surrealfs","name":"surrealfs","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-24601-surrealfs","canonicalPath":"/agent/clawhub-skills-24601-surrealfs","generatedAt":"2026-10-09T22:45:58.105Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection. --- name: surrealfs description: \"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.\" license: MIT metadata: version: \"1.0.2\" author: \"24601\" parent_skill: \"surrealdb\" snapshot_date: \"2026-02-19\" upstream: repo: \"surrealdb/surrealfs\" sha: \"0008a3a94dbe\" --- SurrealFS -- Virtual Filesystem for AI Age","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:24601:surrealfs","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/24601/surrealfs","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/24601/surrealfs","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills c"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"piping","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"piping","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:piping|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No source adoption metrics were available."},"stars":null,"forks":null,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:53:22.550Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T05:53:22.550Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T05:53:22.550Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install skills:24601:surrealfs","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T22:45:58.105Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-24601-surrealfs/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"---\nname: surrealfs\ndescription: \"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.\"\nlicense: MIT\nmetadata:\n  version: \"1.0.2\"\n  author: \"24601\"\n  parent_skill: \"surrealdb\"\n  snapshot_date: \"2026-02-19\"\n  upstream:\n    repo: \"surrealdb/surrealfs\"\n    sha: \"0008a3a94dbe\"\n---\n\n# SurrealFS -- Virtual Filesystem for AI Agents\n\nSurrealFS provides a persistent, queryable virtual filesystem backed by SurrealDB.\nDesigned for AI agents that need durable file operations, hierarchical storage,\nand content search across sessions.\n\n## Components\n\n| Component | Crate/Package | Language | Purpose |\n|-----------|---------------|----------|---------|\n| Core Library | `surrealfs` | Rust | Filesystem operations, CLI REPL, SurrealDB storage layer |\n| AI Agent | `surrealfs-ai` | Python (Pydantic AI) | Agent interface with tool integration, HTTP hosting |\n\n## Rust Core -- Commands\n\nThe `surrealfs` crate provides a REPL with POSIX-like commands:\n\n| Command | Description |\n|---------|-------------|\n| `ls` | List directory contents |\n| `cat` | Display file contents |\n| `tail` | Show last lines of a file |\n| `nl` | Number lines of a file |\n| `grep` | Search file contents |\n| `touch` | Create empty file |\n| `mkdir` | Create directory |\n| `write_file` | Write content to file |\n| `edit` | Edit file contents |\n| `cp` | Copy file |\n| `cd` | Change directory |\n| `pwd` | Print working directory |\n\nSupports piping from external commands: `curl https://example.com > /pages/example.html`\n\nStorage backends:\n- Embedded RocksDB (local)\n- Remote SurrealDB via WebSocket\n\n## Python AI Agent\n\nBuilt on Pydantic AI with tools that mirror the filesystem commands.\n\n```python\nfrom surrealfs_ai import build_chat_agent\n\n# Create the agent (default LLM: Claude Haiku)\nagent = build_chat_agent()\n\n# Expose over HTTP\nimport uvicorn\napp = agent.to_web()\nuvicorn.run(app, host=\"127.0.0.1\", port=7932)\n```\n\nFeatures:\n- Default LLM: Claude Haiku\n- Telemetry via Pydantic Logfire (OpenTelemetry)\n- All filesystem operations available as agent tools\n- HTTP hosting (default port 7932)\n- Path normalization (cannot escape `/`)\n\n## Quick Start\n\n```bash\n# Install the Rust core\ncargo install surrealfs\n\n# Start the REPL with embedded storage\nsurrealfs\n\n# Or connect to a remote SurrealDB instance\nsurrealfs --endpoint ws://localhost:8000 --user root --pass root --ns agent --db workspace\n\n# Install the Python agent\npip install surrealfs-ai\n\n# Run the agent HTTP server\npython -m surrealfs_ai --host 127.0.0.1 --port 7932\n```\n\n## Use Cases\n\n- Persistent workspace for AI agent sessions\n- Hierarchical document storage with metadata queries\n- Multi-agent shared file access with SurrealDB permissions\n- Content strategy and knowledge management\n- Project scaffolding and template management\n\n## Full Documentation\n\nSee the main skill's rule file for complete guidance:\n- **[rules/surrealfs.md](../../rules/surrealfs.md)** -- architecture, Rust core API, Python agent setup, SurrealDB schema, multi-agent patterns, and deployment\n- **[surrealdb/surrealfs](https://github.com/surrealdb/surrealfs)** -- upstream repository\n","readmeExcerpt":"--- name: surrealfs description: \"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.\" license: MIT metadata: version: \"1.0.2\" author: \"24601\" parent_skill: \"surrealdb\" snapshot_date: \"2026-02-19\" upstream: repo: \"surrealdb/surrealfs\" sha: \"0008a3a94dbe\" --- SurrealFS -- Virtual Filesystem for AI Age","codeSnippets":[],"executableExamples":[{"language":"python","snippet":"from surrealfs_ai import build_chat_agent\n\n# Create the agent (default LLM: Claude Haiku)\nagent = build_chat_agent()\n\n# Expose over HTTP\nimport uvicorn\napp = agent.to_web()\nuvicorn.run(app, host=\"127.0.0.1\", port=7932)"},{"language":"bash","snippet":"# Install the Rust core\ncargo install surrealfs\n\n# Start the REPL with embedded storage\nsurrealfs\n\n# Or connect to a remote SurrealDB instance\nsurrealfs --endpoint ws://localhost:8000 --user root --pass root --ns agent --db workspace\n\n# Install the Python agent\npip install surrealfs-ai\n\n# Run the agent HTTP server\npython -m surrealfs_ai --host 127.0.0.1 --port 7932"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection. --- name: surrealfs description: \"SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.\" license: MIT metadata: version: \"1.0.2\" author: \"24601\" parent_skill: \"surrealdb\" snapshot_date: \"2026-02-19\" upstream: repo: \"surrealdb/surrealfs\" sha: \"0008a3a94dbe\" --- SurrealFS -- Virtual Filesystem for AI Age","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":365,"uniquenessScore":67,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T22:45:58.105Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}