v2.1.6

What's Changed

• v2.1.5: restructure, optional signing/notarization, launch at login, CLI status by @aashutoshrathi in #11

Full Changelog: v2.1.5...v2.1.6

v2.1.5

What's Changed

• Toki v2.1.4: click-to-connect onboarding by @aashutoshrathi in #10

Full Changelog: v2.1.4...v2.1.5

v2.1.4

Toki v2.1.4: click-to-connect onboarding

Fresh installs previously hit a dead-end "Config needed / Open README" card and had to hand-write ~/.toki/config.json. This release replaces that with a click-to-connect onboarding screen in the popover.

Added

• Click-to-connect onboarding: when no config.json exists yet, the popover scans for Claude Code (Keychain), Codex (~/.codex/auth.json), and OpenCode (local database) and lets you add them with one click instead of hand-writing JSON. A manual JSON editor link remains for advanced setups.
• Re-scans automatically each time the menu bar icon is clicked while onboarding is showing, so signing into a tool after Toki launched doesn't require a restart.

Fixed

• ConfigLoader.save now creates ~/.toki if it doesn't exist yet, so the first-ever config write (including from the new onboarding flow) no longer fails on a fresh install.
• A config.json that exists but fails to parse is never silently overwritten by the connect flow, and a config.json that's simply empty is no longer treated as a dead end.

Full Changelog: v2.1.3...v2.1.4

• Toki v2.1.4: click-to-connect onboarding by @aashutoshrathi in #10

v2.1.3 - fix launch crash

Toki v2.1.3

A build-only fix: the v2.1.2 DMG crashed on launch. This one starts cleanly.

Fixed

• Launch crash in the packaged app. The released app died immediately with a could not load resource bundle fatal error. SwiftPM's Bundle.module accessor expects its resource bundle at the app root, but code signing requires everything under Contents/ - the two can't both be satisfied. Toki now resolves its resources via Bundle.main from Contents/Resources (where they already ship as plain files), so the fatal accessor is gone entirely.

Everything from v2.1.2 (on-device AI insight, editable AI prompt, UI fixes) is included.

Install

• Homebrew: brew upgrade --cask toki (or brew install --cask toki)
• Direct: download Toki_2.1.3_universal.dmg below, open it, and drag Toki to Applications. The in-app updater will also offer it.

v2.1.2 - on-device AI ships, editable AI prompt, UI fixes

Toki v2.1.2

A focused follow-up to v2.1.1 that actually ships the on-device AI insight, makes its prompt editable, and fixes two UI rough edges.

Highlights

• On-device AI insight now ships. v2.1.1 built on a runner whose SDK lacked Foundation Models, so the AI summary was compiled out of the release. Release builds now run on macOS 26 (Xcode 26), so on macOS 26 with Apple Intelligence you get the real natural-language usage summary; everything below falls back to the deterministic recommendation as before.
• Editable AI prompt. The aiInstructions field now has a dedicated Settings editor - the default prompt shows as placeholder, saving regenerates the insight immediately, and there's a reset-to-default. Shown only when on-device AI is available.

Fixed

• Settings back button now responds across its whole surface, not just the chevron glyph.
• The AI instructions editor surfaces a save failure inline instead of showing a false "Saved".
• Release packaging places the resource bundle under Contents/Resources so the signed app is valid.

Install

• Homebrew: brew install --cask toki (or brew upgrade --cask toki)
• Direct: download Toki_2.1.2_universal.dmg below, open it, and drag Toki to Applications. Or let the in-app updater pull it.

v2.1.1 - agents, on-device insights, self-updates

Toki v2.1.1

get smart --amend --agents turns Toki into an "agents + usage + updates" companion. This release adds live discovery of your running coding agents with jump-to-session navigation, on-device AI usage summaries, OpenCode usage tracking, and an in-app self-updater - plus Homebrew install.

Highlights

• Active coding agents: Toki discovers running Codex, Claude Code, Copilot CLI, OpenCode, and ChatGPT-hosted Codex sessions, showing runtime, working directory, and conversation title - with best-effort navigation straight to the hosting terminal tab or editor.
• On-device AI insights: An AIInsightCard summarizes your usage across accounts in natural language using Apple Intelligence (macOS 26+), with a deterministic recommendation fallback on older systems.
• OpenCode usage: Auto-detected from OpenCode's local SQLite database - today's spend, tokens, and all-time totals.
• Self-updates: Automatic GitHub release checks with verified one-click DMG installation and a manual "Check now" in Settings.
• Homebrew: Install with brew install --cask toki.

Added

• Active-agent discovery for Codex, Claude Code, Copilot CLI, OpenCode, and ChatGPT-hosted Codex with runtime, terminal metadata, and working directory display.
• Conversation title and project folder display for each agent, shown relative to home (~/Code/project).
• Best-effort navigation to matching terminal tabs (iTerm2, Terminal, WezTerm) and editor-hosted sessions (VS Code, Cursor, ChatGPT) via bundle ID resolution.
• On-device AI insight card using Apple Intelligence (macOS 26+) for natural-language account summaries, with a deterministic recommendation fallback and expandable suggestions.
• Session recording banner with a live animated stopwatch while tracking is active.
• OpenCode usage tracking from its local SQLite database (today's spend, tokens, all-time totals), auto-detected when available.
• Automatic GitHub release checks and verified one-click DMG installation.
• Six-hour update polling with a manual "Check now" action in Settings.
• Privacy-safe rotating local diagnostics and an attached debug-report share action.
• Config migration from name/provider/id to label/type with automatic migration and .bak backup.
• In-app JSON config editor.
• Optional aiInstructions config field for customizing the on-device LLM prompt.
• Homebrew cask installation (brew install --cask toki).
• Full-page settings view replacing the Settings tab.
• Copilot provider entry (agent-detection only, no quota tracking).
• OpenCode and Claude SVG logo resources.

Changed

• Release bundles are ad-hoc signed so downloaded updates can be verified before installation.
• Overview panel now uses a unified AIInsightCard replacing three separate stat blocks.
• Account config format migrated to label/type; legacy configs load and convert automatically.
• Provider logos switched to SVG assets with fallback marks for new providers.

Fixed

• Pipe deadlock in subprocess runner: drain stdout and stderr before waitUntilExit.
• Update download URL validation now enforces https scheme alongside host check.
• Guarded FoundationModels behind canImport so release builds succeed on SDKs without the macOS 26 framework.

Install

• Homebrew: brew install --cask toki
• Direct: download Toki_2.1.1_universal.dmg below, open it, and drag Toki to Applications.

v2.1.0 - `get smart --amend`

Toki v2.1.0

get smart --amend makes Toki more useful when you are actively switching between AI coding tools. This release adds recommendations, local usage/event history, DND-aware notifications, session tracking, and a calmer menu bar experience when your quotas are tapped out.

Highlights

• Smart recommendations: Toki now suggests which account to use based on live remaining quota.
• Best Claude account switch: For Claude Code accounts discovered through claude-swap, Toki can switch to the recommended inactive account.
• Break suggestions when quota is empty: When every tracked quota-bearing provider is exhausted, Toki rotates through ten small break suggestions and shows one in the menu bar.
• DND and notification history: Low-quota/session alerts are recorded locally and respect DND/cooldowns so Toki does not spam you.
• Usage history: Toki stores bounded local history so recent quota movement is visible without opening provider tools.
• Session mode: Start a focused coding session and Toki tracks quota burn from the session start.
• Cleaner popover: Accounts, History, Events, and Settings are separated into tabs, with a compact top overview row.

Added

• Smart recommendation state and UI for selecting the healthiest available account.
• One-click best-account switching for Claude Code via claude-swap.
• Local event history for low quota, recovery, DND changes, session warnings, notification delivery, and account switching.
• DND mode and notification cooldown controls.
• Local usage history retention in ~/.toki/usage-state.json.
• Session mode with burn tracking and warning events.
• Settings controls for notification, DND, thresholds, cooldown, retention, and menu bar display mode.
• Menu bar display modes for smart, lowest, Claude, Codex, combined, and account-count views.
• Exhausted-quota break suggestions with menu bar text/emoji.
• Clearer Claude Code extra_usage display as Extra.

Changed

• The popover now uses tabs for Accounts, History, Events, and Settings.
• The overview row now shows Use, Lowest, and Status to save vertical space.
• Menu bar entries now support a lightweight text/emoji leading marker for special states.
• App version is now 2.1.0; bundle build is now 6.

Fixed

• Fixed tab hit targets so the full tab segment is clickable.
• Fixed a refresh cache edge case where startup Refreshing placeholders could be reused instead of fetching Claude data.
• Fixed DND/cooldown event handling so suppressed events do not spam history.
• Fixed notification audit accuracy so an event is marked delivered only after macOS accepts the notification request.

Validation

• swift build
• scripts/build-app.sh
• plutil -p .build/Toki.app/Contents/Info.plist

v2.0.5

What's Changed

• Refactored the monolithic 3166-line main.swift into ~30 files organized by concern (models, API, credentials, discovery, networking, utilities, views, config, store)
• Added GNU General Public License v3
• Fixed CI workflow and build scripts to read version from new Constants.swift path
• Updated build-app.sh to dynamically read version from Constants.swift

Full Changelog: v2.0.4...v2.0.5

v2.0.4

2.0.4 - 2026-07-08

Added

• Debug mode accessible by tapping the version badge 5 times, showing live network request logs and error details in the popover.
• Universal binary (arm64 + x86_64) build with automated DMG packaging via scripts/package-release.sh.
• CI workflow that automatically builds and attaches the DMG to GitHub releases on every v* tag push.
• Error account cards now show a debug badge and expanded error info when debug mode is active.

Fixed

• NSImage concurrency safety warning under Swift 6 strict concurrency checking on CI.
• Refresh guard now logs when skipped due to an in-progress refresh (visible in debug mode).

Changed

• Release CI uses gh release create instead of gh release upload to handle fresh tag-triggered runs.

v2.0.1 - Reset times, glass UI, app icon

v2.0.1

Added

• Reset time display for current and weekly usage in account cards
• App icon (toki-logo.icns)

Changed

• Native glass materials (.ultraThinMaterial / .regularMaterial) instead of custom opacity backgrounds
• Build script copies all Resources into the app bundle

Requirements

• macOS 14+
• Swift 6 toolchain