Start here
Install Kempt and build a working system in about fifteen minutes.
Views are lenses on the file. Check it off in Today and status: done is written back.
Kempt is a local-first home for your notes, plans, and an AI that works on your files. Everything you make lives in one folder on your computer, as plain Markdown you own.
This page walks you from download to a working daily system in about fifteen minutes. The chapters in the sidebar go deeper on each part.
1. Install Kempt
Download Kempt for Windows or macOS from the home page and run the installer.
Note: on Windows, SmartScreen may show “Windows protected your PC” because we are a new publisher. Click More info, then Run anyway. The installer is code-signed; the notice is normal for new desktop apps. More in Troubleshooting.
2. Pick your home folder
On first launch, Kempt asks where your data should live.
- Choose Create a new folder (the suggested location is fine), or Choose an existing folder if you already have Markdown notes. Coming from Obsidian or Notion?
- Confirm with Start with this folder.
Kempt adds two folders (_config/ for settings and the search index, _claude/ for AI settings) and touches nothing else. Copy this folder and you have a full backup.
Note: pick a normal local folder. If you choose a spot inside OneDrive or Dropbox, Kempt warns you: sync engines and live files do not mix well. More in Your data and safety.
3. Create your first area
A workspace is one area of your life: work, daily, a side project. The setup wizard asks for your first one (Create your first area). Give it a name and a color. Add more anytime from the sidebar with New workspace.
The wizard’s first step offers to connect your AI. You can skip it; step 7 below covers it.
4. Capture your first task
Press Q (or Cmd/Ctrl+N) anywhere in the app and type one line:
tomorrow submit the report p1
Kempt reads the natural language: the task is created with tomorrow’s date and priority 1. One line in, one planned task out. More in Find anything, move fast.
5. Shape a plan
- In your workspace, create a project and open it.
- Add a task, then paste several lines of text into it as subtasks: each line becomes its own subtask.
- Now switch the view: List, Board, Timeline, Project Map. Same work, four shapes. Drag a card on the Board and its status changes; drag a bar on the Timeline and its dates change.
Every one of those edits is written to the same plain Markdown file. More in Plan your work.
6. Run your day from Today
Open Today in the left rail. It gathers what is due across every workspace into one list. Check something off and it updates at the source, in its own project and file.
This is the loop Kempt is built around: capture, plan, then work from one honest list.
7. Optional: connect your AI
Kempt works completely without AI. When you want it, the AI panel embeds Claude Code, Anthropic’s agent, running on your own Claude account. No API key, and your notes are not routed through us.
- Open Settings > AI. If Claude Code is already installed, Kempt has found it.
- If not, click Install Claude Code. It needs a paid Claude plan (Pro, Max, Team, or Enterprise).
- Sign in once, then open the AI panel with
Cmd/Ctrl+Land ask something about your notes.
What makes Kempt’s AI different: it learns in the open. Skills and memories are saved as Markdown notes you can read, edit, and undo. And it is not limited to your notes: link an outside folder (a code repository, a client folder) and mention it with @ to let the AI work with what is inside. See Your AI, on your account.
Where next
- Plan your work: the five building blocks and the seven views.
- Notes and knowledge: the editor, wikilinks, graph, canvas, journal.
- Your AI, on your account: setup, permissions, schedules, learning.
- Kempt Sync: encrypted sync across your computers, in beta.
- Your data and safety: backups, version history, leaving anytime.
Stuck? Ask in Discord or email hello@kempt.md.