← Kuku (九九) API Key Guide → 日本語 العربية Español 한국어 Português 繁體中文
Kuku (九九) app icon

Kuku (九九) User Manual

Break your goal into 81 cells, then search straight from them

1. The basic flow

  1. Set a goal and build a 9×9 chart — your goal in the center, 8 elements around it, and 8 items under each element: 81 cells in total.
  2. Tap a cell to dig deeper — the path you took (theme → element → item) becomes the search query, opened in the in-app browser.
  3. Bookmark the good pages — Kuku also records which cell led you to each one.
  4. Write what you learn back into the cells — the chart becomes a living game plan instead of a write-once statement of intent.

▲ The full flow: create → drill down → search → bookmark (2× speed, about 85 seconds, captioned)

2. Creating a chart (4 ways)

Tap in the top right of Home to start a new chart. Enter a central theme, then fill it in one of 4 ways. Whichever you choose, you can edit everything freely afterwards.

a. Write it yourself

Create the chart with just the theme, then tap cells to type directly. A good rule of thumb: carve the elements (the 8 surrounding cells) into distinct areas, and make each item concrete enough to act on.

b. Start from a template (free)

Choose "Create from Template" to pick an 8-element draft from 4 categories: learning, projects, habit building, and exploration. You get a working skeleton instantly, even where AI is unavailable.

c. Generate with on-device AI (free, no network needed)

On Apple Intelligence-capable devices, you can generate an 8-element × 8-item draft on the spot. Everything runs on the device — nothing is sent over the network. → 8. Using AI generation

d. Generate with cloud AI (Kuku Pro + your own API key)

If you have a Claude / Gemini / OpenAI / Qwen API key, you can generate a higher-quality draft grounded in web search. → API Key Guide

New chart screen — theme input and AI generation options

AI and templates only produce drafts. AI never overwrites a cell you typed yourself.

Overview of all 81 cells
Overview of all 81 cells
Drilling down into an element block
Drilling down into an element
A path search opened in the in-app browser
Search by path → in-app browser
Bookmark list
Bookmark list with paths

5. Markdown export (Obsidian / Notion)

6. Settings

7. Kuku Pro (one-time purchase)

Mind map view (Pro)

8. Using AI generation

On-device AI (Apple Intelligence) — free

Cloud AI (Claude / Gemini / OpenAI / Qwen) — Kuku Pro

  1. Get an API key for the provider you want to use. Steps, free tiers, and caveats are covered in detail on a separate page → API Key Guide
  2. Copy the issued key (if you got it on a Mac, you can paste it directly on your iPhone via Universal Clipboard, as long as both use the same Apple ID).
  3. In Kuku, go to Settings → API Keys, tap the paste button next to that provider's field, and save (whitespace is removed automatically; a warning appears if the key belongs to a different provider).
  4. Choose "Cloud AI" on the new chart screen or in block completion to generate drafts grounded in web search.

Each generation request is sent directly to the provider you chose, using your key (it never passes through the developer's servers). API usage fees are billed to you by that provider.

9. Troubleshooting

SymptomCause and fix
"On-device AI" doesn't appear / can't be used Your device doesn't support Apple Intelligence, or it's turned off. Check Settings app → Apple Intelligence & Siri. If it says "Preparing", wait for the model download to finish.
"Couldn't generate because a safety guard was triggered" This is a permanent refusal by the on-device AI's safety features — waiting won't change it. It can happen with real people's names, for example. Try rephrasing, or try cloud AI (it may handle the same content without issue).
Cloud AI generation fails with "Invalid API key" Almost always a paste mistake (leading/trailing whitespace, or a key from a different provider). Re-check or reissue the key following the guide.
"AI usage limit reached" This is a rate limit on the provider's side. Wait a while, or check your usage and billing settings in the provider's console (free tiers have fairly low limits).
Purchased, but Pro isn't active Run Settings → Restore Purchases. You must be signed in with the same Apple ID you purchased with.
Search results won't open (mainland China) Google and DuckDuckGo are not reachable from mainland China. In Settings, switch the search engine to Baidu (it becomes the default automatically if you have not picked one) or Bing.

Still stuck? Feel free to email [email protected].