Field Manual
Making the most of Ditto
Start with the basics, then move into memory, models, agents, and integrations. We write everything here for people who want fewer surprises and know what to do next.
Recommended starting points.
Getting Started with Ditto
Start building with your intelligent memory companion. Learn how Ditto remembers you, adapts to your style, and grows more helpful over time.
AI Models in Ditto
Access the best AI models from every major company. Pick your favorite or let Ditto's smart auto-routing choose the perfect model for you.
Visualizing Your Memory Network
Explore Ditto's unique memory visualization capabilities that show connections between your ideas, questions, and conversations in an interactive graph.
Ditto MCP Server
Choose your MCP client and connect it to your Ditto memories with the right setup values and auth method.
Browse the library.
Every guide, grouped the way the product is organized.
Getting Started
Create your account, pick a plan, and learn your way around.
- Getting Started with Ditto Start building with your intelligent memory companion. Learn how Ditto remembers you, adapts to your style, and grows more helpful over time.
- Plans & Pricing Choose the right plan for your needs. From free access to premium models and advanced features, find the tier that fits your workflow.
- Settings Reference A guide to the settings tabs in Ditto: Account, Models, Memory, Voice, Graphs, MCP, Apps, Agents, Developer, and more.
- Account & Login Create your Ditto account, sign in with email or OAuth, link multiple authentication methods, and manage your profile.
- Account Deletion How to permanently delete your Ditto account and all associated data from the Ditto app.
Core Features
Threads, voice, web search, uploads, images, and models — the everyday surface of Ditto.
- Threads & Conversations Organize your conversations with threads. Create separate contexts for different topics, projects, or workflows, all while keeping your memory connected.
- Voice Features Talk to Ditto with voice input, listen to responses read aloud, and use Live Mode for real-time voice conversations. Choose from dozens of natural-sounding voices.
- Searching the Web with Ditto Learn how Ditto integrates powerful web search capabilities directly into your conversations, providing real-time information access without breaking your flow.
- File & Image Uploads Share images, documents, and audio files with Ditto. Learn about supported formats, size limits, and how Ditto processes your attachments.
- AI Image Creation with Ditto Create stunning visuals with GPT-image-1. Ditto crafts prompts in your style with strong text rendering and high detail.
- Bookmarks Save important messages and responses for quick access later. Bookmark any conversation to build your personal reference library.
- Personality Insights Discover your personality profile through natural conversation. Ditto analyzes your communication patterns to generate Big Five, MBTI, and DISC assessments.
- AI Models in Ditto Access the best AI models from every major company. Pick your favorite or let Ditto's smart auto-routing choose the perfect model for you.
Memory System
How Ditto remembers: the memory graph, sharing, and dedicated graphs.
- Visualizing Your Memory Network Explore Ditto's unique memory visualization capabilities that show connections between your ideas, questions, and conversations in an interactive graph.
- Knowledge Graph Sharing Set your memory graph to private, share it with specific friends, or make it public. Subscribe to friends' and foundation graphs so they fold into your memory search.
- Dedicated Graphs Create a single-purpose knowledge graph you own, get a key scoped to it, and let an agent (or your CI) write memories there — without polluting your main memory.
Integrations
Give Ditto access to your tools — Google Workspace and third-party MCP servers.
- Connected Apps Connect Google Workspace to let Ditto search your emails, manage your calendar, and work with your documents and spreadsheets.
- Connecting MCP Servers to Ditto Give Ditto access to external tools and data by connecting third-party MCP servers. Connect databases, automation platforms, dev tools, and more.
Agents & MCP
Bring your Ditto memory to the agents, editors, and CLIs you already use.
- Agent Integrations Connect Ditto memory to CLI-first agents like OpenClaw and Hermes, or use the MCP server with MCP-capable tools.
- Ditto MCP Server Choose your MCP client and connect it to your Ditto memories with the right setup values and auth method.
- Ditto CLI Install, authenticate, verify, and troubleshoot the Ditto CLI used by CLI-first agent integrations, including agent-native signup.
- Agent-Native Signup Your agent creates its own Ditto account in one command and hands you a claim link — no API key to create or paste.
- Connect Ditto to OpenClaw Paste one prompt into OpenClaw — it installs the Ditto skill, signs itself up, and sends you a claim link. No API key required.
- Connect Ditto to Hermes Agent Paste one prompt into Hermes — it installs the Ditto skill, signs itself up, and sends you a claim link. No API key required.
- Agent Accounts Provision and manage Ditto agent accounts: claim ownership later, pause, resume, or revoke access, restrict to read-only or specific threads, and pre-subscribe agents to foundation graphs.
Developer Platform
Build on Ditto: publish apps, request memory scopes, and share data across apps.
- Building Apps on Ditto Use the Developer tab to create an app, mint API keys with scopes, publish it to the app store, and share per-app tryout links.
- App Permissions Understand the Ditto consent screen and the granular memory scopes apps can request: read, create, update, delete, and archive for your main memory and an app's own sandbox.
- Cross-App Data Sharing Let one of your approved Ditto apps read another app's isolated memory. Grant, list, and revoke cross-app access from the Apps tab.
Mining
Run a miner on Bittensor Subnet 118, from first fork to on-chain submission.
- Mining on Ditto (Subnet 118) Ditto is Bittensor Subnet 118. Miners submit an agent-memory harness; validators score it on correctness, memory recall, and speed; the best harness earns the emissions. Start here.
- Start Mining: From Fork to Live The hands-on path to mining Ditto SN118: fork the reference harness, practice off-chain against DittoBench with your own OpenRouter key, then submit on-chain when your score is strong.
- Submitting to Subnet 118 Exactly what happens when you submit a harness to Ditto SN118: quote the fee, pre-check, pay on chain, upload with proof of payment, and poll the lifecycle — with the guarantees at each step.
- Scoring & Rewards How Ditto SN118 scores a harness: a fresh anti-cheat dataset every run, a composite of tool accuracy and memory recall, multiple validators finalizing on the median, and winner-take-most emissions.
Troubleshooting
Fixes for account and sign-in issues.