# Send End-to-end encrypted .md documents for agents & humans to collaborate. This is a multiplayer alternative to gog and Google Docs that lets people (via CLI) and agents create, search and sync encrypted markdown docs. This service leverages https://ddocs.new which can be enabled locally or via your preferred cloud set-up to make docs accessible across any device or chatbot interface in complete privacy. to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "encrypted-docs", "name": "End-to-end encrypted .md documents for agents & humans to collaborate. This is a multiplayer alternative to gog and Google Docs that lets people (via CLI) and agents create, search and sync encrypted markdown docs. This service leverages https://ddocs.new which can be enabled locally or via your preferred cloud set-up to make docs accessible across any device or chatbot interface in complete privacy.", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/vijaykrishnavanshi/encrypted-docs", "canonicalUrl": "https://clawhub.ai/vijaykrishnavanshi/encrypted-docs", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/encrypted-docs", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=encrypted-docs", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "encrypted-docs", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T19:56:09.504Z", "expiresAt": "2026-05-06T19:56:09.504Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=encrypted-docs", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=encrypted-docs", "contentDisposition": "attachment; filename=\"encrypted-docs-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "encrypted-docs" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/encrypted-docs" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/encrypted-docs", "downloadUrl": "https://openagent3.xyz/downloads/encrypted-docs", "agentUrl": "https://openagent3.xyz/skills/encrypted-docs/agent", "manifestUrl": "https://openagent3.xyz/skills/encrypted-docs/agent.json", "briefUrl": "https://openagent3.xyz/skills/encrypted-docs/agent.md" } } ``` ## Documentation ### Fileverse API - Encrypted .md Docs for Agents & Humans End-to-end encrypted .md documents for agents & humans to collaborate. This is a multiplayer alternative to gog and Google Docs that lets people (via CLI) and agents create, search and sync encrypted markdown docs. This service leverages https://ddocs.new which can be enabled locally or via your preferred cloud set-up to make docs accessible across any device or chatbot interface in complete privacy. Note: A document created via this service is commonly called ddoc or fileverse doc. Each document has a unique randomly generated ddocId. ### Agents - Setup (Device) There are different ways to connect to the Fileverse API. First, you need to get the from the user. ### MCP The fastest way to start is by adding the Fileverse MCP server to your client. Claude Code claude mcp add --transport http fileverse-api Cursor Add this to your ~/.cursor/config/mcp.json: { "mcpServers": { "fileverse-api": { "type": "streamable-http", "url": "" } } } Windsurf Add this to your MCP config: { "mcpServers": { "fileverse-api": { "type": "streamable-http", "url": "" } } } Note: if for some reason MCP is not supported you can fallback to API and check the documentation on the guide.md for exact API Docs. ### MCP ChatGPT ChatGPT supports MCP connectors via Developer Mode (available for Pro, Plus, Team, Enterprise, and Edu users). Setup steps: Open ChatGPT > Settings > Apps > Advanced > toggle Developer Mode on Go to Settings > Apps > click Create Fill in: Name: API Encrypted Docs Server URL: https:/// (e.g. https://abc123.ngrok.app/mcp) Check "I trust this provider" Click Create Using in a chat: Start a new chat Ask it to create a .md file and store it on Fileverse Claude (Web) Open Claude > Settings > Connector > Add Custom Connector Fill in: Name: API Encrypted Docs Server URL: https:/// (e.g. https://abc123.ngrok.app/) Click Add ### MCP Tools Reference The Fileverse MCP server exposes 8 tools. All tools return JSON responses. ### fileverse_list_documents List documents stored in Fileverse. Returns an array of documents with their metadata and sync status. Parameters: NameTypeRequiredDescriptionlimitnumberNoMaximum number of documents to return (default: 10)skipnumberNoNumber of documents to skip (for pagination) Returns: { "ddocs": [{ "ddocId": "...", "title": "...", "content": "...", "syncStatus": "synced", "link": "..." }], "total": 42, "hasNext": true } Usage notes: Use skip and limit to paginate through large document sets Check hasNext to determine if more documents are available Documents are returned with full metadata including syncStatus and link ### fileverse_get_document Get a single document by its ddocId. Returns the full document including content, sync status, and content hash. Parameters: NameTypeRequiredDescriptionddocIdstringYesThe unique document identifier Returns: { "ddocId": "abc123", "title": "My Document", "content": "# Hello World\\n\\nThis is my document.", "syncStatus": "synced", "link": "https://ddocs.new/d/abc123#encryptionKey", "localVersion": 3, "onchainVersion": 3, "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-02T00:00:00.000Z" } Usage notes: The link field is only available when syncStatus is "synced" The link contains an encryption key fragment after # for end-to-end encryption ### fileverse_create_document Create a new document and wait for syncing. Returns the document with its sync status and public link once synced. Parameters: NameTypeRequiredDescriptiontitlestringYesDocument titlecontentstringYesDocument content (plain text or markdown) Returns: { "ddocId": "newDoc123", "title": "My New Document", "content": "...", "syncStatus": "synced", "link": "https://ddocs.new/d/newDoc123#encryptionKey" } Usage notes: This tool blocks until the document is synced to decentralized storage networks (up to 60 seconds) Content supports full markdown syntax The returned link is a shareable, encrypted URL to view the document on ddocs.new If sync takes too long, the tool returns with syncStatus: "pending" - use fileverse_get_sync_status to poll later ### fileverse_update_document Update an existing document's title and/or content, then wait for the syncing with decentralized storage networks. Parameters: NameTypeRequiredDescriptionddocIdstringYesThe unique document identifiertitlestringNoNew document titlecontentstringNoNew document content At least one of title or content must be provided. Returns: Updated document object with sync status and link. Usage notes: This tool blocks until the update is synced to the decentralized storage networks (up to 60 seconds) Only provided fields are updated; omitted fields remain unchanged Each update increments the localVersion ### fileverse_delete_document Delete a document by its ddocId. Parameters: NameTypeRequiredDescriptionddocIdstringYesThe unique document identifier to delete Returns: { "message": "Document deleted successfully", "data": { "ddocId": "abc123", "..." } } Usage notes: Deletion is permanent The document's decentralized storage networks’ (including a public blockchain for content hash registry) record will also be updated ### fileverse_search_documents Search documents by text query. Returns matching documents ranked by relevance. Parameters: NameTypeRequiredDescriptionquerystringYesSearch query stringlimitnumberNoMaximum number of results (default: 10)skipnumberNoNumber of results to skip Returns: { "nodes": [{ "ddocId": "...", "title": "...", "content": "...", "syncStatus": "..." }], "total": 5, "hasNext": false } Usage notes: Searches across document titles and content Results are ranked by relevance Use skip and limit for pagination ### fileverse_get_sync_status Check the sync status of a document. Returns the current syncStatus and link if synced. Parameters: NameTypeRequiredDescriptionddocIdstringYesThe unique document identifier Returns: { "ddocId": "abc123", "syncStatus": "synced", "link": "https://ddocs.new/d/abc123#encryptionKey", "localVersion": 3, "onchainVersion": 3 } Usage notes: syncStatus can be: "pending", "synced", or "failed" Use this to poll for sync completion after create/update operations localVersion vs onchainVersion shows if there are unsynced changes ### fileverse_retry_failed_events Retry all failed decentralized storage networks sync events. Use this when documents are stuck in "failed" sync status. Parameters: None Returns: { "retried": 3 } Usage notes: Call this when you notice documents with syncStatus: "failed" Returns the count of events that were retried Events have a maximum of 10 retry attempts before being permanently marked as failed Failed events are typically caused by decentralized storage networks (including a public blockchain) rate limits or transient network errors ### Document Sync Lifecycle Understanding the sync lifecycle helps agents work effectively: Create/Update → syncStatus: "pending" → decentralized storage networks sync → syncStatus: "synced" → syncStatus: "failed" (retry with fileverse_retry_failed_events) pending - Document saved locally, waiting for decentralized storage networks sync synced - Document is on-chain and has a shareable link failed - Sync failed (rate limit, network error). Use fileverse_retry_failed_events to retry The create and update tools automatically poll for up to 60 seconds. If sync hasn't completed by then, use fileverse_get_sync_status to check later. ### Constraints & Limits ConstraintValueMax file upload size10 MBDefault page size10 documentsSync polling timeout60 secondsSync poll interval3 secondsMax event retries10 attemptsWorker concurrency5 concurrent events ### Common Patterns Creating documents from local files: "Upload this README to a ddoc" "Sync my notes.md to Fileverse" "Create a ddoc from this file" Generating new content: "Create a ddoc that explains and documents this codebase" "Write a design doc for [feature] and save it as a ddoc" "Create a ddoc summarizing today's meeting notes" Managing existing documents: "List all my ddocs" "Search my ddocs for anything about authentication" "Update my project roadmap ddoc with the latest changes" "Delete the old draft ddoc" "What's the sync status of my latest document?" Sharing: “Sync these ddocs across all my agents for shared context and memory” "Create a ddoc and give me the link" "Get the shareable link for my [document name] ddoc" “Collaborate with these people on my [document name] ddoc” ### Best Practices for Agents Always return the link - After creating or updating a document, return the link field to the user so they can view/share it Use search before creating - If the user wants to update something, search first to find the existing document instead of creating a duplicate Handle sync failures - If a document's syncStatus is "failed", call fileverse_retry_failed_events and inform the user Paginate large result sets - Use skip and limit when listing documents to avoid loading everything at once Use markdown - Content supports full markdown. Format documents with proper headings, lists, code blocks, and tables Check sync status - If create/update returns with syncStatus: "pending", poll with fileverse_get_sync_status until it's "synced" before giving the user the link Create a skill - It's recommended for LLMs to create a skill/shortcut for common Fileverse operations to make it easier for users to interact with the API (e.g., /ddoc create, /ddoc list) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: vijaykrishnavanshi - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T19:56:09.504Z - Expires at: 2026-05-06T19:56:09.504Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/encrypted-docs) - [Send to Agent page](https://openagent3.xyz/skills/encrypted-docs/agent) - [JSON manifest](https://openagent3.xyz/skills/encrypted-docs/agent.json) - [Markdown brief](https://openagent3.xyz/skills/encrypted-docs/agent.md) - [Download page](https://openagent3.xyz/downloads/encrypted-docs)