Kairos v0.1.2
Name your sessions and watch them live in the status line.
What changed
kairos --title "Foo" claude— name the activity when you launch it. Composes with--project; the title reaches the Claude Code plugin viaKAIROS_ACTIVITY_TITLEand now updates even when you resume an existing session, not just on first start.- Per-session status line. A new
activities.statusRPC feedskairos-claude-code statusline, renderingActivity: <name> [Focused|Gracing|Idle] ⏱<total> [<today>]with color. Add it to.claude/settings.json:"statusLine": { "type": "command", "command": "/path/to/kairos-claude-code statusline", "refreshInterval": 15 }
- Cheap status reads. A daemon-side
StatusIndexcache rebuilds once per ingested event (not per poll) with a provably-exact live tail for the focused activity, so frequent status-line renders stay off the heavy attribution path. The focused/gracing/idle classifier is now shared between the status line and the menu dot.
The daemon, CLI, and dashboard otherwise behave as in v0.1.1.
Downloads
| File | Mac |
|---|---|
Kairos-0.1.2-arm64.zip |
Apple Silicon |
Kairos-0.1.2-x86_64.zip |
Intel |
Requires macOS 14 (Sonoma) or newer.
Install
- Unzip, then drag Kairos.app into /Applications.
- The app is ad-hoc signed (not notarized). On first launch Gatekeeper will block it — right-click the app → Open, or drop the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/Kairos.app
- Launch Kairos — it runs as a menu-bar item. Open the Dashboard and configure idle/AFK, clients, and projects from its menu.
Claude Code plugin (optional)
In the app: Configure → Plugins → Claude Code → Register, then install with the Claude Code CLI:
claude plugin install kairos-claude-code@kairosSee the README for the full setup guide.