One home for your work, with an AI companion that knows it

Everything for every project in one place, with AI superpowers.

Tasks, time, clients, notes and files, all organized by project and kept on your own machine. Whether you ship code or run a freelance practice, Kaisho is the one place your work lives, with an AI companion that can see all of it. It drafts your invoices, briefs your week, and remembers every decision, so you run your work instead of chasing it.

Kaisho dashboard Kaisho dashboard
// kaisho desktop · dashboard v2.8.3
Kanban AI SHell Organizer
MIT · local-first · yours, always
Projects

One project. Everything about it in one place.

A project is the home for a piece of work. It belongs to a client and gathers that work’s tasks, tracked time, notes and files, with a description, milestones and a status board. It answers the question every scattered tool leaves open: where does everything for this engagement actually live?

// 01 · gathers

Tasks & time, rolled up

Add a task inside a project and it inherits the client and files under the right milestone. Log hours against it and they total on the project automatically. You assign the work, the time follows.

Website Redesign · ACME
  tasks   12 · 3 open
  time    47h logged
// 02 · together

Notes & files, together

Briefs, exports, contracts, screenshots and quick notes live on the project they belong to. Drag a file straight onto it: images and PDFs preview inline, text and Markdown edit in place.

files/
  brief.pdf
  logo-v3.png
notes  kickoff · scope-change
// 03 · at a glance

Milestones & a status board

Break the work into milestones with due dates and watch progress fill up at a glance. Drag whole projects across Active, On hold, Completed and Archived, the same feel as the task board.

Design   [======  ] 80%
Build    [==      ] 25%
Launch   [        ]  0%

Belongs to a client · rolls up tasks, time, notes & files · new in v2.7

Getting started

Up and running in minutes.

Install the app, put your work into projects, and let the AI help.

Install

Grab the desktop app for macOS, Windows or Linux from GitHub Releases, or install via pip install kaisho && kai serve. Your projects, tasks, time, clients and notes live in plain files on your own machine. No account required.

Organize by project

Create a project for each engagement and drop its tasks, hours, notes and files inside. Everything for a piece of work finally has one home instead of being spread across ten different tools.

Let the AI help

Ask the companion what’s due, what’s unbilled, or who’s over budget, or set it to brief you and draft invoices on a schedule. Bring your own model, or use the hosted AI on your Kaisho server.

Features

Everything your work needs, without the tab-juggling.

Kaisho replaces the scatter of a to-do app, a time tracker, a client list, a notes tool and a folder of files with one app that keeps them in step, and hands the whole picture to your AI.

// 01 · projects

Projects that hold everything

Every task, hour, note and file organized under the client work it belongs to, with milestones and a drag-to-change status board. Open a project and the whole engagement is right there.

// 02 · tasks & time

Tasks and time, in one flow

A drag-and-drop board for what’s next and one-click timers for what you’re on now. Hours roll up to the task, the project and the client automatically, ready to bill with no spreadsheet required.

// 03 · clients

Clients, contracts and invoices

Keep every client with their projects, budgets and contracts in one place. Preview unbilled time, export a clean CSV for your accountant, and see who’s close to budget before it becomes a problem.

// 04 · knowledge

Notes and a knowledge base

Capture decisions, meeting notes and how-tos as plain Markdown. The knowledge base is a second brain that you and your AI can search later, so nothing you learn gets lost.

// 05 · AI

An AI companion that sees it all

One assistant with the full context of your work: it plans, tracks, drafts and remembers. Ask it anything in plain language, or schedule it to run on its own. Bring your own model or use the included quota.

// 06 · yours

Yours, on your machine

Local-first by default: plain text or SQL, no lock-in, works offline. Add hosted sync and a phone app when you want them, and cancel anytime with your data untouched where it started.

How it flows

Your tracked work becomes your AI’s memory.

Each step feeds the next. Kaisho turns tracked time into context, context into automation, and automation back into knowledge, so nothing leaks between the cracks.

// 01 · track

Track

Book time, close a task, or update a budget from the app, the terminal, or just by asking in plain English.

$ kai book 30m "ACME" --project rebrand
// 02 · ask

Ask

Ask anything, grounded in real numbers. "Who’s closest to budget?" pulls from your clocks. "What’s unbilled from May?" sums it by client.

you › who is closest to budget?
  ACME  147h / 200h  · 73%
// 03 · automate

Automate

Schedule the boring parts: a Monday-morning briefing, a Friday invoice draft from unbilled time, a nightly summary of what moved.

every friday 17:00
  draft invoice from unbilled
// 04 · remember

Remember

Findings get written back to your knowledge base: client quirks, decisions, how-tos. The next session starts pre-briefed, not from zero.

+ notes/ACME/billing.md

remember → track → the loop closes

Your AI companion

An AI that has actually read your work.

Most AI starts every chat from zero. Kaisho’s companion doesn’t: it can see your projects, tasks, tracked hours, clients and notes, so you just ask. "What’s due this week?" "Who’s closest to budget?" "Draft an invoice from May’s unbilled time." It answers in real numbers, and with your say-so it acts: adds the task, books the time, writes the note.

// 01 · ask

Ask in plain language

Talk to it like a colleague who already knows the account. Every answer is grounded in your real data, not a guess, and you never copy-paste context in.

you › what's unbilled from May?
  ACME     18.5h · €2,775
  FOXLABS   6.0h · €900
// 02 · automate

Put the busywork on autopilot

Schedule it to run on its own: a Monday briefing on last week, a Friday invoice draft from unbilled time, a nightly summary. It does the work and leaves you the result.

every friday 17:00
  draft invoices from unbilled time
// 03 · remember

It remembers across sessions

Decisions, client quirks and how-tos get written back to your knowledge base, so the next conversation starts already briefed instead of from scratch.

+ notes: ACME billing quirks
+ kb: deploy-checklist.md

Bring your own model or use the included quota · your data never trains anyone else’s

Knowledge base

The second brain that survives every session.

Tasks close. Timers reset. The knowledge base grows. What you learn in one session becomes context for the next, written once in plain Markdown, searchable by you and by your AI through the same tools it uses for everything else.

Kaisho knowledge base Kaisho knowledge base
// kaisho desktop · knowledge kb/
kb/clients/acme/billing-notes.md

VAT rules per project type, the accountant’s preferred invoice format, and who to CC on monthly statements.

kb/projects/rebrand/decisions.md

Why we dropped the second logo direction, and exactly what the client signed off on in the kickoff.

kb/how-to/release-checklist.md

The steps to ship a release, in order, so nothing gets skipped at 6pm on a Friday.

kb/meetings/2026-05-kickoff.md

Scope, deadlines and the three things the client said matter most, captured before they were forgotten.

All entries are plain Markdown. Your AI reads them, writes to them, and never asks you the same question twice.

For power users

Every feature is also a command.

Prefer the keyboard? Everything in Kaisho is a kai command: start a timer, add a task, draft an invoice or query your notes, and the same commands are available to your AI. The graphical app is optional. There’s even an Emacs mode that keeps your clock in the mode line.

~/work · kai
$ kai book 30m "RIDING BYTES" --tag dev booked 0:30 to RIDING BYTES · dev $ kai task add "Ship 2.3.2" --customer "RIDING BYTES" added #482 Ship 2.3.2 [todo] $ kai cust list --status active RIDING BYTES 147h / 200h 73% FOXLABS 41h / 60h 68% GLOBEX 218h / 220h 99% $ kai mcp serve mcp server 127.0.0.1:8765 · 38 tools ready for claude-code · cursor · claude-desktop
Storage

Your data, your way.

Keep everything in plain text you can read and back up yourself, in portable JSON, or in a SQL database for teams and scale. The app, the terminal, your phone and your AI all work the same across every option, with no lock-in, ever.

Default

Plain text

Org-mode or Markdown files on your disk. Inspectable, diff-able, Git-friendly.

Portable

JSON

One structured document set. Easy to back up, script against, and integrate.

For teams

SQL

SQLite or Postgres for concurrent access and scale. Built for teams and professional deployments.

The plain-text backends are human-readable end to end:

* [2026-06-01 Mon] CLOCK: [2026-06-01 Mon 09:30]--[2026-06-01 Mon 10:00] => 0:30 :PROPERTIES: :CUSTOMER: RIDING BYTES :CONTRACT: dev-2026 :TASK_ID: a81b5f2e :END: Convert: preserve clock notes on org -> sql import.
## 09:30-10:00 · RIDING BYTES <!-- customer: RIDING BYTES contract: dev-2026 task_id: a81b5f2e start: 2026-06-01T09:30:00 end: 2026-06-01T10:00:00 --> Convert: preserve clock notes on org -> sql import.
[ { "customer": "RIDING BYTES", "contract": "dev-2026", "task_id": "a81b5f2e", "start": "2026-06-01T09:30:00", "end": "2026-06-01T10:00:00", "notes": "Convert: preserve clock notes." } ]
* TODO Ship 2.3.2 :PROPERTIES: :CUSTOMER: RIDING BYTES :TASK_ID: a81b5f2e :TAGS: release dev :END: Preserve clock notes during org -> sql import.
## Ship 2.3.2 <!-- id: a81b5f2e state: todo customer: RIDING BYTES tags: release, dev --> Preserve clock notes during org -> sql import.
{ "id": "a81b5f2e", "title": "Ship 2.3.2", "state": "todo", "customer": "RIDING BYTES", "tags": ["release", "dev"] }
* RIDING BYTES :PROPERTIES: :STATUS: active :BUDGET: 200h :USED: 147h :CONTRACT: dev-2026 :END:
## RIDING BYTES <!-- status: active budget: 200h used: 147h contract: dev-2026 -->
{ "name": "RIDING BYTES", "status": "active", "budget_h": 200, "used_h": 147, "contract": "dev-2026" }
Mobile

Your work in your pocket

The mobile app gives you the same projects, tasks, time and clients as your desktop, and the same AI companion, with the same memory. Book time on the go, check what’s due, ask a quick question. It syncs through a Kaisho server, one you host yourself or one we host, so your time tracking stays under your control.

PWA dashboard
Dashboard
PWA timer
Timer
PWA advisor
AI Companion
PWA entries
Entries
Open Mobile App
Integrations

Works where you already work.

Drive Kaisho from Claude Code, Cursor or Claude Desktop; run any model you like on the back end; keep open storage you can pipe anywhere else. No lock-in, on either side.

Claude Code Cursor Claude Desktop Emacs Zed (MCP) Ollama LM Studio OpenAI API Anthropic API OpenRouter Google Calendar CalDAV Linear GitHub Projects Slack org-mode SQLite PostgreSQL

Connect your AI in two clicks.

When Kaisho is running, any compatible AI client can reach your projects, tasks, clocks, clients and notes at a local endpoint. The token lives on your machine; nothing leaves it.

claude mcp add --transport http kaisho \
  http://localhost:8765/mcp/ \
  --header "Authorization: Bearer <your-token>"

"Open in Kaisho" needs the desktop app (v2.3.1 or later) installed. If nothing happens when you click it, install Kaisho first, then come back.

Pricing

Free and open source.

Kaisho is free and fully open source, yours forever. Run the optional cloud yourself for cross-device sync and AI, or use our hosted option (coming soon).

Local
Free
Open source. No account needed.
  • Full desktop app (macOS / Win / Linux)
  • Projects, tasks, time, clients, notes, KB
  • All your data, your machine only
  • Bring your own API key (any model)
  • Local AI via Ollama / LM Studio
  • Full CLI & self-hosted AI access
View on GitHub

Hosted sync and AI as an optional subscription is coming soon. Everything else is free and self-hostable today.

FAQ

Common questions

Do I have to be a developer to use Kaisho?
No. Kaisho started with developers, but at its core it’s a project, time and client manager with an AI companion, just as useful for freelancers, consultants and anyone who runs client work. Developers get extras like editor integration, a CLI and a knowledge base of code gotchas, but none of it is required to get value on day one.
What exactly is a project?
A project is the home for one piece of work. It belongs to a client and gathers that work’s tasks, tracked time, notes and files, with a description, milestones and a status board. Assign a task to a project and its hours roll up automatically, so a project always answers “where does everything for this engagement live?”
Can I use my own AI model?
Always. Local is bring-your-own-key by design: Claude, OpenRouter, GPT, Gemini, local Ollama, LM Studio, any OpenAI-compatible endpoint. A connected Kaisho server (self-hosted or ours) can add a hosted frontier model so you can skip the key-juggling, but you can still point at your own provider for sensitive work.
Where is my data stored?
Always on your machine. Kaisho is local-first: your projects, tasks, time, clients and notes live as plain files in a directory you own. A connected Kaisho server (self-hosted or ours) adds a hosted sync layer so the phone app and your other devices stay in step, but the source of truth never leaves your laptop.
What are scheduled AI runs?
Jobs that run a prompt against your Kaisho data on a schedule: a Monday briefing on last week, a Friday invoice draft from unbilled time, a nightly summary. They run on your machine, or on our hosted runner (Companion) so they fire even when your laptop is closed. Templates are included, and you can write your own.
Is it still a real time tracker and invoicing tool?
Yes. The kanban board, one-click timers, client and contract budgets, unbilled-time preview and CSV export are all there and fully maintained. We lead with projects and the AI companion, but nothing underneath was removed. If you only want a time tracker, Local is enough and always will be.
Does it work with Claude Code, Cursor, and Claude Desktop?
Yes, all three are first-class targets with a one-line setup. See the integration guide for the exact config per app. The same server works with any other compatible client too. Companion adds a hosted gateway so your tools stay reachable when your laptop is closed.
Can my team use it together?
Yes. Point Kaisho at a SQL backend to share projects and a knowledge base across a team. Or stay solo with plain files: it’s the same app either way, and you can move between them without leaving anything behind.
Open source

Open source. Under your control.

Kaisho is MIT-licensed, top to bottom. Run the desktop app, the sync server and the AI on your own hardware, and track time from your phone through a Kaisho server you host yourself. Prefer not to run one? Point the apps at a Kaisho-hosted instance, the same open-source image. Either way, the source is on GitHub, the data is yours, and the whole thing works without us.

View on GitHub
The Mark

One home for your work, with an AI companion that knows it

In Japanese martial arts, kaisho (開手) means “open hand”, the position of readiness. The mark is an open bracket with three lines: the bracket is the palm, the lines are what you carry, your tasks, hours and ideas.

The bracket is not closed. It accepts new entries, holds what matters, and expands when you need it to. Structure without rigidity.