Frequently Asked Questions
Find answers to the most common questions about SHISHO. If you don't see what you're looking for, feel free to reach out to us.
Session Integration
What AI tools are supported?
SHISHO supports 25+ AI tools including Claude Code, ChatGPT, Cursor, GitHub Copilot, Gemini CLI, Codex, Aider, Roo Code, Cline, and more. Just run `shisho setup` to configure integration with your tools.
Sessions aren't being sent automatically
Run `shisho login` to refresh your token. Check `~/.shisho/watch.log` for errors. Sessions sync every 30 minutes via cron, or on session end via hook. You can run `shisho watch` manually to test.
How does session sync work?
There are two methods: (1) Hook-based — fires automatically when a session ends or is compacted. (2) Periodic watch — a cron job every 30 minutes detects changed session files. Both use the same API.
Plans & Pricing
What can I do on the free plan?
Unlimited memos, 3 AI chats/month, 5 natural language searches/month, 2 session ingests/month, and whimsical auto-diary by SHISHO. Upgrade for more AI features.
How do I change plans?
Go to Settings > Plan & Billing > Manage. You can upgrade or downgrade anytime through the Stripe Customer Portal.
What happens when I downgrade?
Over-limit memos are moved to trash (recoverable for 30 days). Media goes to trash as well. Books become read-only. Nothing is immediately deleted.
Library
What are Books?
Books are AI-generated content created from your memos and sessions. There are 4 types: Daily Diary, the monthly magazine "The SHISHO Pictorial", Topic Note, and Album. SHISHO, your librarian, writes them for you.
How does the daily diary work?
For paid users, it's auto-generated daily at your preferred time. For free users, it works in "kimagure" (whimsical) mode — SHISHO writes a diary when you log in, if yesterday's memos exist.
Can I edit Books?
Books are read-only AI-generated content. However, you can add annotations on top — highlights, notes, and bookmarks.
What happens when I open a shelf?
Your library shelves are private by default. Opening a shelf (from its publish settings) makes the books on that shelf readable via a share link — a read-only page anyone can open in a browser. Your raw memos are never published; only the books you've shelved. When connected to MyMCP, your AI can read that shelf's knowledge too. You can switch it back to private anytime.
Data & Privacy
Where is my data stored?
Google Cloud (Tokyo region). AES-256 encryption at rest, TLS encryption in transit. Media is accessed via signed URLs and is never publicly accessible.
Can I export my data?
Yes, memos can be exported as Markdown from the memo page.
How do I delete my account?
Go to Settings > Account > Delete Account. Your Firebase account will be disabled and your data will be marked for deletion.
MCP Integration
What is MCP?
Model Context Protocol — it lets AI tools read and write your SHISHO data directly. Search your memos and save conversations from any MCP-compatible AI.
How do I set up MCP?
Run `shisho setup` to automatically configure MCP for Claude Code and Codex. For claude.ai, add the remote MCP server URL (https://mcp.shisho.me) in your settings.