Your first 10 minutes

Seven small steps. Afterwards you know the parts of ZimeZumi you will use every day. Boards, desktop notes and the AI window can wait.

  1. Choose your vault. On first launch create a new vault. If you want ZimeZumi on iPhone or iPad too, put it in iCloud Drive (section 2).

  2. Write your first note. Click the new note button in the sidebar. Type a title and two lines. Watch the save status on the right: it saves by itself (section 5).

  3. Give it a place. Drag the note from the INBOX into a life area or folder. Right-click the folder and give it a colour (section 3).

  4. Open My Day. Click the calendar icon in the sidebar and write down the three things that matter today (section 4).

  5. Pin and tag. In the meta bar above your first note, click the pin and add the tag first.

  6. Find it again. Press ⌘P and type a word from the note, or click the tag first in the topic index (section 11).

  7. Look at the Dashboard. Open it from the sidebar: today’s My Day, your pinned note and what you worked on are all there.

That is the core: capture, let it save, give it a place, find it again.

1 · The three things to know first

If you read nothing else, read this.

  1. Your vault is a folder. Every note is a standalone HTML file you can open in any browser. Back it up, sync it, move it: it stays yours, with or without ZimeZumi.

  2. Capture first, sort later. New notes land in the INBOX. Give them a place when you have a minute; the Dashboard reminds you under “To file”.

  3. There is no save button. ZimeZumi saves while you type. The save status on the right of the toolbar confirms it.

2 · Where you use ZimeZumi

ZimeZumi is one product on three kinds of device. The Mac app is the full version. The iPhone and iPad apps are companions for reading, capturing and editing. All of them work on the same vault.

Device

What it is for

How you get it

Mac

Everything: editor, boards, desktop notes, import, export, AI window, MCP

DMG from the ZimeZumi website (address below). 14 days free, then a one-time license (section 15)

iPhone

Capture, read, edit with a basic editor, My Day, search, Siri

Free in the App Store

iPad

Like the iPhone, plus colours, highlights, knowledge blocks, tables and boards with Apple Pencil

Free in the App Store

ZimeZumi website: posthopeproduction.com/zimezumi

Install on the Mac

Open the DMG and drag ZimeZumi into your Applications folder. The built-in MCP server (section 13) expects the app there. In macOS the app is called Zimezumi; it is the same app.

Choose or create your vault

On first launch you choose an existing folder or create a new vault. If you also want ZimeZumi on iPhone or iPad, create the vault in iCloud Drive right away. A new vault starts with an INBOX, the life areas Knowledge, Projects and Archive and this handbook. If ZimeZumi runs in German, the life areas are called Wissen, Projekte and Archiv. Opening an existing vault adds nothing and overwrites nothing, and a vault that has gone missing is never silently recreated.

Language

ZimeZumi speaks English and German. English is the default; you can also follow the system language. The language you use when you create a vault decides the names of its first life areas. Switching the language later changes the interface only, never your notes, folder names or file names.

3 · Your vault and the sidebar

The sidebar on the left is your library. At the top: the vault name with the buttons for a new note and for search. Below: the INBOX, PINNED and LIFE AREAS with their folders. At the bottom: the buttons for My Day, the Dashboard and Settings.

ZimeZumi on the Mac: sidebar with INBOX, pinned notes and colourful life areas, a note open on the right

The library: INBOX, pinned notes and life areas on the left; on the right the open note with its path, the meta bar and the toolbar.

INBOX

The INBOX is where new notes land: from the new note button, from browser capture, from Siri on the iPhone and from your AI client. You choose which folder serves as INBOX in Settings. Drag its lower edge to make it taller or shorter; a double-click resets the height.

Life areas and folders

Life areas are the big worlds, for example Projects, Knowledge or Archive. Inside them you nest folders as deep as you like. Click a life area to fold it; the two buttons at the top fold everything or open all life areas at once. “Manage life areas” adds, renames, recolours and reorders them, and you can drag a life area to a new position.

Every folder can have a colour and one of ten monochrome symbols. Right-click a folder for colour, symbol, new note, new folder, new board, pin and the other actions. Sorting is alphabetical or by time.

Notes: pin, colour, tags, protection

The meta bar right above the note holds the pin, the table switch, the colour marker for the title (“Highlight”) and the tags; on its right sit the outline, the backlinks and the date. The padlock and the desktop button (section 10) sit in the toolbar at the top right, next to the zoom. A grey open padlock means editable, a blue closed padlock means protected: the note can be read and copied, but not changed or deleted until you unlock it. Above the title, the path shows where the note lives, in the colour of its life area.

The right-click menu of a note in the sidebar

Right-click a note in the sidebar.

4 · Dashboard and My Day

The Dashboard

The Dashboard button in the sidebar opens an overview of your vault. The list view is the default:

Section

What it shows

My Day

Today’s note (or “Create today’s My Day”) and the two most recent earlier days, with the My Day folder beside the heading

Pinned folders · Pinned notes

Up to five entries each

Recently active

The ten notes you worked on last

To file

What is still in the INBOX, so nothing gets lost

Badges

Every badge type you use in your notes, with the number of notes behind it. A click unfolds the notes.

The Dashboard in list view

The Dashboard: My Day, pinned folders and notes, recently active, to file and, at the bottom, your badges.

The card view shows the same areas as cards with a short preview of each note. Previews are limited on purpose, so the Dashboard stays fast even in a large vault.

Folder dashboard: while the Dashboard is open, click a folder in the sidebar. You see what was active there recently, what is colour-marked, and below everything in the folder from A to Z, subfolders first. “Main dashboard” takes you back; the X closes the Dashboard and returns you to your last note.

My Day

The calendar icon in the sidebar opens today’s note or creates it. A My Day note is a structured page for the day: what matters, what you did, what you noticed. In Settings › My Day you decide whether ZimeZumi creates the note automatically, which folder it goes into (the INBOX by default), which template it uses and the date format. You can edit your own template or take an existing note as the template; days that already exist never change.

Today’s My Day note

My Day: a structured note for today, here with quick notes and a short morning check-in.

5 · Writing in the editor

Click into a note and write. ZimeZumi saves automatically; the save status on the right confirms it. Everything you format is stored as plain, readable HTML.

Ways to format

The right-click menu on selected text

Right-click on selected text.

Headings and sections

H1 to H3 each have their own colour. H1 and H2 sections fold with the arrow in front of them, and the state is stored in the note. One command folds or opens all H2 sections at once, and a single undo takes it back. A folded section can be copied whole and moved up or down at its level. A step heading carries a visible step number, useful for instructions.

Headings and paragraphs can be centered with the Center button next to H1 to H3, with ⌘⇧E or from the right-click menu. Lists, checklists, tables and code always stay left.

Blocks that structure a note

Block

Use it for

Knowledge blocks

A side note, an information, a confirmed result or a warning in its own coloured box with rounded corners

Data card

Key facts in a small table inside a highlighted card, like the status card at the top of this handbook

Table

Comparisons and lists with columns. Add rows and columns, a header row and merged cells from the table menu or the right-click menu. Since 4.7.1 a table is as wide as its content and has rounded corners; very wide tables scroll sideways.

Checklist

Things to tick off inside a note. ZimeZumi is not a task manager; for tasks with dates use a task app.

Quote, caption, code, divider

A thought set apart, a line of context under something, commands or code with highlighting, a visible break

Link and note cards

A web link, a local file or another note as a compact card with its title

A note with headings, knowledge blocks, a table, a checklist and badges

A note with step headings, knowledge blocks, a table with status badges, highlights and a checklist.

For a single note you can switch off table borders and cell backgrounds with the table button in the meta bar; the layout stays exactly the same.

Colour and emphasis

Bold, italic, strikethrough and inline code, plus 14 text colours and 6 highlight colours. Badges are small status labels in the text: neutral, info, success, warning and danger. The Dashboard counts them for you.

Comfort

6 · Images, galleries, files and PDF

Images

Insert images with the image button, drop them from the Finder or paste them from the clipboard. Adding an image never replaces one you had selected. Drag the corners to resize. Right-click an image to copy it, open it in macOS, show it in the Finder or turn it into a Finder link.

Text beside images (since 4.7): right-click a single image and choose “Left, text wraps” or “Right, text wraps”. The image takes 40 percent of the column, you can drag it up to 60 percent, and your text runs beside it. Lists and quotes stay beside the image; headings, tables, galleries, code, knowledge blocks and cards start below it. In a narrow window, and on the iPhone in portrait, the image spans the full width. “Align left” and “Center” bring it back into the line; centering and wrapping exclude each other.

An image on the right with text running beside it

Text beside images (since 4.7): one image on the right, one on the left, the text runs beside them.

Galleries

Select several images with ⇧-click and choose “Create gallery”. A gallery shows four, five or six images per row. Drop more images onto it to add them; the same image is never taken twice.

Files, PDFs and media libraries

A gallery and a PDF attachment card in one note

A gallery with four images per row, and a PDF read right inside the note.

7 · Markdown block and quick view

Since 4.7 a Markdown file can live inside a note without being converted. Insert it with the MD button in the toolbar, with /md, or by dragging a .md file into the note. The text stays Markdown, is searchable and keeps its link to the original file.

A Markdown block in a note

A Markdown block linked to its .md file, and on the right the quick view of another .md file from the media library.

On iPhone and iPad, Markdown blocks are shown read-only; refreshing happens on the Mac.

8 · The AI window

The AI window rewrites a passage you selected. It works on the Mac and uses the Claude Code or Codex you already have, with your own Claude or ChatGPT subscription. ZimeZumi has no AI of its own, needs no API key and stores none.

Action

What you get

Rephrase

The same content in new words

Shorten

A tighter version

Expand

A fuller version

Spelling and grammar

Corrections only

Summarize

The core in a few sentences

With instruction …

Your own instruction of up to 300 characters, alone or as a hint for one of the actions

How it works

  1. Select the text. Open the AI window with the AI button in the toolbar, with ⌘⇧K or by right-clicking and choosing AI.

  2. Pick an action, or type your own instruction and click Run.

  3. The draft appears at the top, with the changed words highlighted, and your original below it.

  4. “Apply” (⌘↩) replaces the passage; ⌘Z undoes it. “Insert as new text” puts the draft below your selection and keeps the original. “Again” asks once more, “Discard” or Esc throws the draft away.

The AI submenu with Rephrase, Shorten, Expand, Spelling and grammar, Summarize and With instruction

Right-click › AI: the actions for a selected passage.

The AI window with a draft above the original

The AI window: the draft with the changed words highlighted, your original below, then Apply, Insert as new text, Again or Discard.

The window floats above the editor, you can move it, and it stays open while you select the next passage. If the passage changed in the meantime, Apply is locked so nothing gets mixed up.

Setting it up

Settings › AI: choose the provider (Claude Code, Codex or Off). ZimeZumi finds the program, shows its status and version, lets you pick a model and “Test connection”. If the program sits in an unusual place, enter its path by hand.

Settings, AI card with provider, status and model

Settings › AI: Claude Code found, model chosen, Test connection.

9 · Boards

A board is a canvas for thinking in space: drawings, shapes, text and cards for notes and files. It is stored as an HTML file in your vault like every note. Right-click a life area or folder and choose “New board”.

A board with drawings, shapes, arrows and source cards

A board: a drawing, shapes, text, arrows and cards for notes, an image and a PDF.

A board with the Sources panel open

The Sources panel: add notes, images, PDFs and files. Every card keeps its link to the original.

The status at the top says “Saved”; the Save button stores the board at once. Check it before you switch away. If the file changed elsewhere while you were drawing, ZimeZumi keeps your draft and offers to save a copy. To share a board, export it as complete board HTML; it can be imported again as a board. On the iPad you draw on boards with Apple Pencil (section 16); on the iPhone boards are read-only.

10 · Desktop notes

A note can leave the app and sit on your Mac desktop as its own small window, with the full editor inside. Click the monitor symbol right next to the padlock in the toolbar (“Pin note on desktop”). Click it again, or the X on the window, to take it off the desktop. In the vault nothing changes.

Two desktop notes in front of the ZimeZumi main window

Two desktop notes in front of the main window: each has a pin, a button back to the app and its own save status.

11 · Search, links and references

Search the vault

⌘P opens the search. It looks in titles, text and tags across the whole vault, tolerates typos, and ranks title matches higher. Below the search field sit the topic index (your tags) and the note markers (your title colours); both work as filters and can be combined. ⌘F searches inside the open note.

The search palette with results and filters

⌘P searches the whole vault. Here the tag #Travel narrows the results.

Links between notes

Link another note as text or as a card; drag a note from the sidebar into a note for a quick note card. Internal links survive moving and renaming. Web links and Finder links stay as they are.

References, outline and reference view

A note with the references inspector and the outline

Outline and backlinks: every heading of the note, and every note that links here.

12 · Import, capture, export and backup

Import

Settings › Import content › “Open import …”. ZimeZumi reads TXT, CSV, JSON, XML, source code, RTF, DOC, DOCX, ODT and PDF and turns them into editable notes. Markdown notes and whole Obsidian vaults come in with their folders, links and reachable attachments. Your source files are only read, never changed.

HTML files can simply be dragged: into the editor, the content goes into the open note; onto the sidebar, a new note appears in the INBOX with its embedded images and attachments. Scripts from foreign pages are never run.

Browser capture

With the Safari or Chrome extension that comes with ZimeZumi you save a page, a selected text or an image straight into the INBOX. Set it up in Settings › Browser Capture.

Export a note

Format

Use it for

PDF

A fixed, printable version for reading and sending

Markdown

Working on the text in other tools

HTML

One portable file with the note’s images and attachments inside. It opens in any browser and can be imported into another ZimeZumi vault.

The three export buttons sit on the right of the toolbar.

The export options for a note

Top right: zoom, padlock, desktop button, save status and the three export formats.

Back up the whole vault

Settings › Export & backup: “Create HTML backup …” saves the complete vault as a lossless ZIP, “Entire vault as Markdown …” as a portable copy for other apps. Backups are started by you and saved outside the vault. Files that live outside the vault, for example in media libraries, need their own backup.

Vault Guard (Settings › Vault Guard) finds missing references and attachments that nothing uses any more. You look at the list before anything is moved to the trash.

13 · Connect your AI client (MCP)

MCP lets an AI client you use, such as Claude Desktop, Claude Code, the ChatGPT desktop app or Codex, search, read and write your vault. The MCP server is built into ZimeZumi: no extra download, no web service, no API key, and the app does not even need to be open.

Set it up

  1. Open ZimeZumi with the right vault and go to Settings › AI & MCP.

  2. Click “Check connection”. The four checks Vault, MCP server, Connection and Version must all be green.

  3. Click “Copy configuration”. The copy already contains the exact path of your open vault and the server name zimezumi.

  4. Add it to your AI client and restart the client.

Settings, AI and MCP after a successful connection check

Settings › AI & MCP after Check connection: all four checks green.

Client

Where the configuration goes

Claude Desktop

Quit Claude Desktop completely. Open its configuration file (path below), back it up, then add the zimezumi entry under mcpServers without removing other entries. Reopen Claude Desktop.

Claude Code

Run the command below in Terminal, then start a new session and check with /mcp.

ChatGPT desktop app

Settings › MCP servers › Add server: name zimezumi, type STDIO, command and argument as below. Save and choose Restart.

Codex

Run the command below, then open a new terminal session or restart the extension.

The paths and commands for each client:

Claude Desktop, configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code:
claude mcp add zimezumi --scope user -- /Applications/Zimezumi.app/Contents/Resources/mcp/zimezumi-mcp "--vault=/PATH/TO/VAULT"

ChatGPT desktop app, command and argument:
/Applications/Zimezumi.app/Contents/Resources/mcp/zimezumi-mcp
--vault=/PATH/TO/VAULT

Codex:
codex mcp add zimezumi -- /Applications/Zimezumi.app/Contents/Resources/mcp/zimezumi-mcp "--vault=/PATH/TO/VAULT"

/PATH/TO/VAULT stands for the path from your copied configuration. The ChatGPT website cannot reach a local MCP server; use the desktop app or Codex.

What your AI can do

26 tools: list, search and read notes, find passages, follow links, list tags and folders, create notes, update and append, rename, set tags and colours, add attachments, create folders, and plan moves, folder renames and tag changes that you confirm separately. Since 4.7 the passage search hands the AI the few matching sections of a long note, each with the headings above it, instead of the whole note. Under “Allowed file folders” you decide from which folders on your Mac the MCP server may copy images and attachments into the vault.

14 · Settings and appearance

Card

What you set there

App language

English, Deutsch or System

License

Demo state, license key, buy a license (section 15)

Appearance

Paper, Dark paper, Dark or Follow Mac; Custom colors (the Color lab); the navigation tree size; note counts in life areas and folders

My Day

Automatic daily note, folder, template, date format

INBOX

Which folder serves as the INBOX

AI

Provider for the AI window, model, test connection; ask when dropping .md files

AI & MCP

Check connection, copy the configuration, allowed file folders

Browser Capture · Import content · Export & backup · Vault Guard

See section 12

Color lab: under Custom colors you set background, text and accent, the text colour of the navigation tree, the colours of code blocks, and with one slider the hues of H1, H2 and H3 together. Light, Warm and Dark are starting points, the live preview shows every change, and contrast checks tell you whether everything stays readable. Your palette applies on this Mac only; notes, markers and folder colours stay unchanged. “Restore base colors” takes you back.

Settings, Appearance with the four modes, the Color lab and the tree size

Settings › Appearance: four modes, Custom colors, tree size and note counts.

The Color lab with surface, tree, heading and code colours and contrast checks

The Color lab under Custom colors, with contrast checks.

15 · License and demo

ZimeZumi Desktop runs fully for 14 days. After that, everything you already have stays usable: open, edit, save, search, export and back up. A license is needed only to create something new: new notes and boards, imports, browser capture, new My Day notes, notes created over MCP and the AI text actions. The iPhone and iPad apps are free and have no license check.

  1. Buy ZimeZumi Desktop at posthopeproduction.com/store.html. The license line comes by email; it starts with “PHP1.”.

  2. Settings › License: paste the whole line and click “Check license”. The check runs immediately and offline, without a restart.

  3. The card now shows “Licensed to Name (email)”. Before that it shows “Demo, N days left” or “Demo ended”.

Settings, License in the demo

Settings: app language and license, here during the demo.

The license is a line of text in ~/Library/Application Support/Zimezumi/license.txt. Placing the file there by hand works too. No account, no device binding, no internet check.

16 · iPhone and iPad

The mobile app works on the same vault as your Mac. It is the companion: capture on the way, read, edit, plan the day. The full program stays on the Mac.

Connect your vault

  1. Make sure the vault lies in iCloud Drive (section 2).

  2. Open ZimeZumi on the iPhone or iPad, choose “Select existing folder” and pick exactly the same vault folder.

  3. Wait until the files are downloaded. Only what is downloaded is available offline.

Finding your way

The bar at the bottom has five places: Dashboard, Life areas, + for a new note in the INBOX, My Day and Pinned with a counter. The app starts in Life areas. The mobile Dashboard shows your ten most recently active notes, grouped by Today, Yesterday, Last 7 days and Older, and below them up to five pinned folders. Search sits at the top and filters by text, tags and colours at once.

ZimeZumi on the iPhone: life areas with folders, the search field and the bottom bar

Life areas, with search at the top and the bottom bar: Dashboard, Life areas, +, My Day, Pinned.

The Dashboard on the iPhone with recently active notes grouped by Today and Yesterday

The mobile Dashboard: recently active notes, grouped by day.

The Dashboard on the iPhone scrolled down: last 7 days and three pinned folders

Further down: Last 7 days and your pinned folders.

Search on the iPhone for “weekend”, narrowed to the tag #Travel, five notes found

Search: “weekend”, narrowed to the tag #Travel.

Reading and editing

A note opens for reading. Tap the pencil (Edit) to change it; this deliberate step protects you from accidental edits. The iPhone offers undo and redo, headings, bold, italic, underline, lists, quote and divider. The iPad adds text colours, highlights, knowledge blocks and table editing. Colours, folder symbols, headings and tables look the same as on the Mac. Wide tables scroll sideways inside the table.

A note in reading view on the iPhone with knowledge blocks and a table with status badges

A note in reading view. The pencil top right switches to editing.

ZimeZumi on the iPad: library and note side by side, the note in edit mode with the formatting bar

iPad: library and note side by side, here in edit mode with the formatting bar. Cancel or Save at the top.

From version 4.7, images with text beside them and Markdown blocks from the Mac are shown as on the Mac; you set or refresh them on the Mac.

My Day on the go

My Day in the bottom bar opens today’s note or creates it, with the folder, date format and template you chose on the Mac. It even finds a day you renamed or moved.

Boards with Apple Pencil (iPad)

On the iPad you draw on boards with Apple Pencil and use shapes, arrows, lines, text, the eraser, selection, undo and redo; colour, line weight and line style apply to the next object. Fingers pan and zoom. Saving is deliberate. If the board changed elsewhere in the meantime, your drawing stays open and can be saved as a copy. On the iPhone boards are read-only.

A board on the iPad in edit mode with the tool bar, colour, line weight and line style

A board on the iPad in edit mode: tools, colour, line weight and line style. Pencil draws, fingers pan and zoom.

Capture from anywhere

Not on iPhone and iPad: MCP, browser capture, desktop notes, vault imports, the AI window and editing the My Day template. The appearance (System, Light, Dark) is chosen in the library menu.

17 · Nothing gets silently overwritten

18 · Quick reference

I want to

Where

Write a quick note

New note button in the sidebar or the INBOX; iPhone: + in the bottom bar or Siri

Open today’s note

Calendar icon in the sidebar; iPhone: My Day in the bottom bar

See what I worked on

Dashboard › Recently active

Find a note

⌘P; in the open note ⌘F

Fold all chapters of a long note

Outline at the top right, or the command for all H2 sections

Center a heading or paragraph

⌘⇧E

Put an image beside the text

Right-click the image › Left, text wraps or Right, text wraps

Insert a Markdown file

MD button, /md, or drag the .md file into the note

Rewrite a passage

Select it, ⌘⇧K, pick an action

Keep a note on my desktop

Monitor symbol next to the padlock

Protect a note

Padlock in the toolbar

Send a note as one file

HTML export on the right of the toolbar

Back up everything

Settings › Export & backup › Create HTML backup …

Connect Claude or ChatGPT

Settings › AI & MCP

Enter my license

Settings › License

Change the look

Settings › Appearance

19 · If something does not work

Problem

What to check

The AI client does not reach ZimeZumi

Is ZimeZumi in Applications? Settings › AI & MCP › Check connection, copy the configuration again, restart the client.

The AI uses the wrong vault

Copy the configuration again while the right vault is open. The path behind --vault= must be the one you want.

MCP gone after an update

Copy the new app into Applications, check the connection, restart the client.

The AI window says the program is missing

Settings › AI › Search again, or enter the path by hand. Claude Code or Codex must be installed and signed in.

A note cannot be edited

Check the padlock. On iPhone and iPad tap the pencil (Edit) first.

“Demo ended” when creating something

Settings › License, paste the license line, Check license. Existing notes stay usable.

iPhone does not show a change from the Mac

Same iCloud vault? Wait until the file is downloaded, then reload.

Bug reports are welcome at the support address on posthopeproduction.com/zimezumi. Please name the device, the version, what you did just before, what you expected and what happened instead.

Changelog

Date

Change

05.10.2026

Edition for ZimeZumi 4.7.2: every new vault now comes with this handbook. Setting up a vault in English creates the life areas Knowledge, Projects and Archive. Long paths moved out of two tables so they read well on the iPhone.

03.10.2026

First edition of the complete English user handbook for ZimeZumi Desktop 4.7.1 and ZimeZumi 4.7 for iPhone and iPad, built from the guides Getting Started, iOS Quick Guide, Editor Demo and A to Z (state 4.5.5) and the function reference (state 4.7.1).