Agentic Storage
Tusky provides persistent storage that AI agents can use to save files, share data, and maintain context across sessions. Files are encrypted client-side and synced to the Walrus decentralized network for durable, censorship-resistant storage.
Agents interact with Tusky through tool calls (MCP), typed methods (SDK), or shell commands (CLI). Encryption, upload orchestration, and Walrus sync happen transparently — the agent just calls “upload” and the rest is handled.
Integration paths
Section titled “Integration paths”| MCP Server | TypeScript SDK | CLI | |
|---|---|---|---|
| Best for | Claude Code, Claude Desktop, Cursor | Custom agent code, CI/CD pipelines | Shell scripts, automation |
| Interface | Tool calls (JSON-RPC over stdio) | Typed async methods | Shell commands |
| Encryption | Transparent (passphrase + SEAL) | Manual (bring your own crypto) | Transparent (passphrase + SEAL) |
| Setup | tusky mcp install-config | npm install @tuskydp/sdk | npm install -g @tuskydp/cli |
| Vault types | Public, private, shared | Public, private, shared | Public, private, shared |
| 29 tools | Yes | All methods available | All commands available |
Most agent integrations use the MCP server — it gives any MCP-compatible agent full access to Tusky through standardized tool calls. The SDK is better for custom agent code where you want typed methods and fine-grained control. The CLI works well for shell-based automation and CI/CD.
What agents can do
Section titled “What agents can do”- Create and manage vaults — organize files into public, private (encrypted), or shared (multi-party encrypted) containers
- Upload and download files — from local disk paths or inline content, with automatic encryption for private and shared vaults
- Read file content directly — inspect text or binary files without writing to disk (ideal for sandboxed agents)
- Organize with folders — create hierarchical folder structures within vaults
- Share vaults with other agents or users — grant and revoke access by Sui address, with on-chain SEAL encryption
- Manage trash — soft-delete with 7-day recovery, permanent deletion when needed
- Retry failed syncs — re-trigger Walrus sync for files that encountered errors
Supported agents
Section titled “Supported agents”| Agent | How it connects | Setup |
|---|---|---|
| Claude Code | MCP server via .mcp.json | tusky mcp install-config --target claude-code |
| Claude Desktop | MCP server via app config | tusky mcp install-config --target claude-desktop |
| Cursor | MCP server via ~/.cursor/mcp.json | tusky mcp install-config --target cursor |
| Any MCP-compatible agent | MCP server via stdio | Configure tusky mcp serve as the command |
| Custom agents | TypeScript SDK | npm install @tuskydp/sdk in your agent code |
Workflows
Section titled “Workflows”These guides walk through common agent storage patterns step by step: