v0.1.2

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 via KAIROS_ACTIVITY_TITLE and now updates even when you resume an existing session, not just on first start.
• Per-session status line. A new activities.status RPC feeds kairos-claude-code statusline, rendering Activity: <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 StatusIndex cache 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

1. Unzip, then drag Kairos.app into /Applications.
2. 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

3. 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@kairos

See the README for the full setup guide.

v0.1.1

Kairos v0.1.1

Attribution fix release. The bundled Claude Code plugin now correctly tracks time during AskUserQuestion and ExitPlanMode.

What changed

• Human-input tools no longer read as one long AI grind. AskUserQuestion (answering a question) and ExitPlanMode (approving a plan) hand control to you mid-turn. The plugin now emits ai_stop when the agent asks and ai_submit when you answer/approve, so your reading/deliberation time is counted as focus — not deducted as idle AI wait. Previously a long "grilling" or plan-review turn was a single giant [ai_submit, ai_stop] span that swallowed the time you spent answering.
• EnterPlanMode is excluded (instant mode flip, no human wait).
• Plugin version bumped to 0.1.1 (it versions independently of the app).

The daemon, CLI, and dashboard are unchanged from v0.1.0; this release mainly ships the fixed plugin and bumps the version.

Downloads

File	Mac
Kairos-0.1.1-arm64.zip	Apple Silicon
Kairos-0.1.1-x86_64.zip	Intel

Requires macOS 14 (Sonoma) or newer.

Install

1. Unzip, then drag Kairos.app into /Applications.
2. 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

3. 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@kairos

See the README for the full setup guide, and the docs for the architecture and protocol.

v0.1.0

Kairos v0.1.0

First public release.

Kairos is a native macOS menu-bar daemon that tracks genuine human time per AI coding agent — plus meetings and ad-hoc work — with a built-in dashboard and a Claude Code plugin. Swift + Rust, not Electron.

Downloads

File	Mac
Kairos-0.1.0-arm64.zip	Apple Silicon
Kairos-0.1.0-x86_64.zip	Intel

Requires macOS 14 (Sonoma) or newer.

Install

1. Unzip, then drag Kairos.app into /Applications.
2. 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

3. 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@kairos

See the README for the full setup guide, and the docs for the architecture and protocol.