Kanso

Frequently asked questions

Jump to a topic, or read straight through.

.
Getting started
.
Editor
.
iCloud sync
.
Themes
.
Import
.
Markdown
.
Privacy
.
MCP
.
iPad
.
Troubleshooting
.
Shortcuts
.
Pricing

Getting started

Where do I download Kanso?

From the Mac App Store and the iPhone App Store. Search for "Kanso Notes" or use the download links on the home page.

Why is the App Store name "Kanso Notes" but the app says "Kanso"?

"Kanso" alone was already taken on the App Store. The display name on your device is just "Kanso".

How do I create my first note?

Press .N on Mac, or tap the + button on iPhone. New notes default to plain markdown; pick a different type from the rail to start a Current note, Idea, Grocery list, Recipe, Journal entry, or Sketch.

Editor

Where did the markdown markers go?

They're hidden until your caret is on or near the line. Click into a heading and you'll see the #; move away and it goes back to formatted text. The underlying file always contains the markdown - what changes is what's drawn.

Why didn't my typo get auto-corrected?

Spell check fires on word boundaries. Hit space, return, or punctuation and Kanso applies the system's standard correction quietly. Right-click any underlined word for alternates.

Can I drag a checked item to the bottom?

In a Grocery note, checked items move to a "Done" group automatically and can be cleared with one menu item. In a regular note, drag the line yourself.

iCloud sync

Where are my notes stored?

As plain .md files in iCloud Drive / Kanso /. You can open the folder in Finder and edit those files in any other text editor - Kanso will pick the changes up.

What if I don't use iCloud?

Notes stay on your device, in the app's local container. If you turn iCloud on later, Kanso moves them up.

Does Kanso work offline?

Yes. The app reads and writes local files; iCloud handles propagation in the background. You can edit on a plane and conflicts will resolve when you reconnect.

A note shows two copies with weird suffixes - why?

That's iCloud's conflict marker. It happens when the same note was edited on two devices before either had a chance to sync. Open both, copy the text you want to keep into one, and delete the other.

Themes

How do I change the theme?

Settings > Appearance. Five themes ship: Paper (default), Retro, Graphite, Sage, and Terminal.

Why does Terminal force dark mode?

Green text on a black background is the point. Terminal looks the same in light, dark, and system modes.

Import

What can I import from?

FSNotes, nvAlt, Obsidian, Bear, Apple Notes, Simplenote, Evernote, Google Keep, and any plain Markdown folder.

Can I undo an import?

Yes. Kanso checkpoints your notes folder before writing imported notes. Settings > Imports has a "Revert last import" option.

Markdown

Which dialect of markdown does Kanso use?

CommonMark plus GitHub-style task lists (- [ ]) and YAML frontmatter for per-note metadata (type, tags, due date, recipe servings, etc.).

Will my notes work in other editors?

Yes. They're plain markdown files. The frontmatter is human-readable and most other markdown editors will display the body just fine, ignoring the parts they don't understand.

Privacy

What does Kanso send back to you?

Nothing. There's no analytics SDK, no crash reporter, no telemetry of any kind. Read the full privacy policy.

When does the app make a network request?

Only when you trigger one: dropping a recipe URL fetches that page, and bring-your-own-key AI features call the provider you configured. iCloud sync goes through Apple, not us.

MCP / AI

Is there an MCP server?

One is in development so Model Context Protocol clients like Claude Desktop can read and edit your notes locally. It isn't part of the App Store release yet.

Do I need an AI key?

Only for Kanso's optional in-app AI features. Everything else works without one.

iPad

Is there an iPad version?

Coming soon. The iPhone build runs on iPad in compatibility mode in the meantime, but the layout is not yet optimized for it.

Troubleshooting

A note disappeared.

Check Trash in the rail. Deleted notes stay there for 30 days before being purged.

An iCloud edit didn't show up on my other device.

Force a sync by pulling down on the note list (iPhone) or running Settings > Sync now (Mac). If that doesn't work, check iCloud Drive is enabled for Kanso in System Settings.

How do I send a bug report?

Email terranvigil@gmail.com or open an issue on GitHub.

Keyboard shortcuts (Mac)

New note.N
New tab.T
Close tab.W
Reopen closed tab..T
Jump to tab 1-9.1-9
Jump to rail item 1-9..1-9
Search.F
Reset font size.0

Pricing

Is Kanso really free?

Yes. No subscription, no in-app purchases, no upsells. If a Pro tier ever ships, the core editor and sync stay free.

How is it sustainable?

Kanso is built and maintained by one person as a side project. The marginal cost of a download on the App Store is zero, and there's no server to keep running.