Working with Pages
A Miki page is a document AI writes from your notes and keeps current as those notes change. You describe what you want in plain language; AI decides which notes are relevant and synthesizes them. See [1] for how pages differ from notes.
Creating a page
From Organize, create a new page and give it two things:
- A title — "Sourdough", "House renovation", "What I'm learning about Rust".
- Instructions — what this page should collect and how to present it, in ordinary language. "Everything about my sourdough experiments, newest first, with what worked and what didn't." "A chronological timeline of the renovation, one line per event."
Instructions are where the leverage is. The same set of notes produces a very different page depending on what you ask for — a summary, a timeline, a comparison table, a FAQ, a set of open questions. It's worth being specific.
A brand-new page starts empty and out of date. Nothing runs automatically: click Refresh and AI will find the relevant notes and write the page. See [2] for what that costs and the other ways to trigger it.
The two views: Page and Notes
A page leads a double life — a finished article, and the collection of notes behind it. Two tabs switch between them:
Page shows the AI-written result, rendered as an article with citations back to source notes. There's a button to copy the raw markdown if you want to take it elsewhere.
Notes shows the underlying notes as cards, in three sections:
- Pinned — notes you attached by hand. AI never removes these.
- Referenced — notes the current page text actually cites.
- Other associated — notes AI matched to this page but didn't end up quoting.
The tab you're on is part of the address, so a link to the Notes view stays on the Notes view when somebody else opens it.
How a page picks up notes
Most pages work by searching your notes and letting AI judge each candidate against your instructions. Two kinds of page skip that entirely, and the page shows a small badge when it is one of them.
All notes. Write a page whose instructions name nothing to include or exclude — "All Notes", "Everything I've written" — and it takes every note in that space, with new ones joining as you write them. No AI decides what fits, so nothing is left out and it costs no AI credits.
The moment you name something, it is an ordinary page again. "All my notes about cooking" is a subject, "all my notes from this year" is a timeframe, and "everything except work" is an exclusion — each of those is a rule that has to be applied to each note, which is exactly what the ordinary path does.
Manual. Say you'll choose the notes yourself — "I'll add the notes to this page by hand" — and AI will never add or remove one. Drag notes on, or use the + beside the Pinned heading. A page whose instructions don't describe anything at all lands here too, with a warning explaining why it is empty: filling it with unrelated recent notes would be worse than leaving it alone.
Either way, you change the mode by editing the page's title and instructions — there's no separate switch to find.
Pinning notes
AI decides which notes belong to a page, and mostly it's right. When it isn't, pinning is the override.
Two ways to pin: drag a note from the notes list onto the page, or use the + next to the Pinned heading. Adding a page from the note's side pins it too.
A pinned note is permanent — no AI run will ever drop it. An unpinned note you remove by hand is remembered, so the next match run does not simply put it back — but a page only remembers its last 100 removals, and past that the oldest is forgotten. If you keep removing the same note, pin the ones you do want instead.
Refreshing
Refresh brings a page up to date. It runs in two stages: find the relevant notes, then write the page from them. Each stage has a mode:
- Auto (the default) works incrementally — it looks at what's new or changed and adds to what's already there. Fast and cheap.
- Full refresh re-evaluates everything from scratch: re-finding every relevant note, or rewriting the whole page. Slower and costs more.
Auto is the right answer almost always. Reach for a full refresh when you've substantially changed a page's instructions, or when the page has drifted and you want a clean slate. Both modes live under Advanced Settings in the refresh dialog.
Refresh All, from the Organize page, refreshes every page in the current space in one go. You can also have it run on a schedule — see Automatic Refresh All below.
Staleness
Small amber markers appear on notes, page cards, and pages themselves. They mean "this changed since AI last processed it" — either notes underneath moved, or the page text is older than the notes it's built from. They're a hint about where a refresh is worth spending on, not a warning.
Automatic Refresh All
Account → AI Settings decides whether Refresh All also runs on a schedule:
- Manual — nothing refreshes unless you ask for it, from the Refresh All button, the API, or MCP.
- Free: every 6–12 hours — the default. We run Refresh All for you every 6 to 12 hours and it costs you no AI credits. This is a bonus for Alpha, the early stage Mikipage is in now while we shape the product with a small group of users; expect it to change once Mikipage leaves Alpha.
Either setting covers your Personal space and every group you own. A group owned by someone else follows its owner's setting.
Layered instructions
Three levels of instruction stack, from general to specific:
- Personal AI Instructions (Account → AI Settings) apply to every one of your personal pages. Good for standing preferences: your writing style, your timezone, the fact that "the boys" means your kids.
- A group's description does the same job for that group's pages. It's both a description for humans and instructions for AI.
- The page's own instructions are the specific brief.
The more general layers are worth filling in once — they save you repeating yourself on every page.
Editing a page
You don't, really. A page's text is AI's output, so the way to change it is to change what goes in: edit the notes underneath, or rewrite the page's title and instructions, then refresh.
When you genuinely want to take the wheel, use Save as Note. That snapshots the page's title, instructions, and current text into an ordinary note you can edit freely — and which AI will no longer maintain. By default it also lists every note on the page that the text doesn't already cite, under References, so no note gets left behind. The page itself stays put; delete it yourself if the note replaces it.
Behaviour worth knowing
A page can only cover so much. There's a ceiling on how many notes AI considers per refresh (500), how much it reads, and how much it writes, and one page trying to be about everything will meet them. None of them loses a note — a later refresh picks up the candidates the last one didn't reach, and pinned notes bypass the matching step entirely — but a page that broad reads badly for people too. The fix is to narrow the instructions, split the page into several focused ones, or remove notes that aren't really relevant. [3] has the actual numbers and what happens at each.
Instructions are assumed to be stable. Routine refreshes only ever add — they won't remove associations that no longer fit. So if you rewrite a page's instructions to mean something substantially different, run a Full refresh to clear out what no longer belongs, or just create a new page and delete the old one.
Taking a note away doesn't fully erase it. Editing a note marks every page built from it as stale, and a routine refresh folds the new version in. Removing a note from a page — or deleting the note outright — marks those pages stale too, and the refresh will try to strip what the note contributed. But it can only reliably remove what was directly cited to that note. A passage synthesized from several notes at once may keep traces of the one you took away. If something lingers after a refresh, run a Full refresh.
Publishing
A page in a public group is readable by anyone, at a friendly URL you choose. That's how this documentation is published. See [4].
Related
No comments yet.