# Kairos

> Offline planner that auto-places tasks and learns how long they take.

- Page: https://www.whatwemade.app/p/kairos
- What it is: Mobile app, for productivity
- Made by: [SKOHscripts](https://www.whatwemade.app/u/skohscripts)
- Run it yourself: get the code and run your own copy
- Website: https://skohscripts.github.io/Kairos/app
- Code: https://github.com/SKOHscripts/Kairos (MIT, 15 stars)
- Languages: German, English, Spanish, French, Italian, Russian
- Status: in progress, 70% built
- Upvotes: 0, comments: 0

## About

Kairos plans your day for you. You add tasks; it places them automatically in the free gaps of your calendar, around meetings and with a buffer after each one, in the order given by a WSJF priority score (value plus deadline criticality, divided by effort). Each task shows its score and explains it in one tap. It also protects deep-work blocks, times the real work, and alerts you when a task runs over its estimate.

Its time estimates improve by themselves. An on-device machine-learning model learns from your finished tasks how long the next ones will really take: nearest neighbours on your history, with a ridge regression as a fallback. A new task gets a duration, a range and the list of similar tasks it came from, and the model only replaces the default duration once it beats it on your own history. Training and prediction run entirely on your device.

It was made as an alternative to cloud planners: no account, no ads, no network, and your data stays on your device. Devices can sync through a file you link in a Syncthing or Nextcloud folder, with no server.

The hard parts were keeping one Kotlin Multiplatform codebase running on Android, Windows, Linux, macOS and the browser (Wasm), and making the automatic placement and the learned estimates explainable rather than a black box. The repo follows a spec-first workflow, with a spec for each domain in docs/spec.

## How it was made

- Claude Code, 75% of the work: Specs, Kotlin implementation, tests and docs
- Stack: SQLite

## What you need to run it

- Tools: JDK 21 and Gradle (to build from source)
- Platform: Android, Windows, Linux, macOS or a browser

Shared on WhatWeMade: https://www.whatwemade.app/p/kairos