Question 1

What AI tools are supported?

Accepted Answer

Nokos supports 25+ AI tools including Claude Code, ChatGPT, Cursor, GitHub Copilot, Gemini CLI, Codex, Aider, Roo Code, Cline, and more. Just run `nokos setup` to configure integration with your tools.

Question 2

Sessions aren't being sent automatically

Accepted Answer

Run `nokos login` to refresh your token. Check `~/.nokos/watch.log` for errors. Sessions sync every 30 minutes via cron, or on session end via hook. You can run `nokos watch` manually to test.

Question 3

How does session sync work?

Accepted Answer

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.

Question 4

What can I do on the free plan?

Accepted Answer

Unlimited memos, 3 AI chats/month, 5 natural language searches/month, 2 session ingests/month, and whimsical auto-diary by Nokos. Upgrade for more AI features.

Question 5

How do I change plans?

Accepted Answer

Go to Settings > Plan & Billing > Manage. You can upgrade or downgrade anytime through the Stripe Customer Portal.

Question 6

What happens when I downgrade?

Accepted Answer

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.

Question 7

What are Books?

Accepted Answer

Books are AI-generated content created from your memos and sessions. There are 4 types: Daily Diary, Monthly Report, Topic Note, and Album. Nokos (the paper fairy) writes them for you.

Question 8

How does the daily diary work?

Accepted Answer

For paid users, it's auto-generated daily at your preferred time. For free users, it works in "kimagure" (whimsical) mode — Nokos writes a diary when you log in, if yesterday's memos exist.

Question 9

Can I edit Books?

Accepted Answer

Books are read-only AI-generated content. However, you can add annotations on top — highlights, notes, and bookmarks.

Question 10

Where is my data stored?

Accepted Answer

Google Cloud (Tokyo region). AES-256 encryption at rest, TLS encryption in transit. Media is accessed via signed URLs and is never publicly accessible.

Question 11

Can I export my data?

Accepted Answer

Yes, memos can be exported as Markdown from the memo page.

Question 12

How do I delete my account?

Accepted Answer

Go to Settings > Account > Delete Account. Your Firebase account will be disabled and your data will be marked for deletion.

Question 13

What is MCP?

Accepted Answer

Model Context Protocol — it lets AI tools read and write your Nokos data directly. Search your memos and save conversations from any MCP-compatible AI.

Question 14

How do I set up MCP?

Accepted Answer

Run `nokos setup` to automatically configure MCP for Claude Code and Codex. For claude.ai, add the remote MCP server URL (https://mcp.nokos.ai) in your settings.

Frequently Asked Questions

Session Integration

Plans & Pricing

Library

Data & Privacy

MCP Integration