---
schema_version: 7
rubric_version: "0.3"
canonical_url: "https://podium.do/compare/agents/products/kooky/"
data_url: "https://podium.do/compare/agents/products/kooky/data.json"
generated_at: 2026-11-22
oldest_checked_at: 2026-11-16
last_checked_at: 2026-11-16
publisher: "Podium"
---

# Kooky: ADE findings

> Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. Sourced findings follow the same evidence rules for Podium and its competitors. Facts labeled Podium team research come from Podium's own team and have no linked source. None of this removes the conflict of interest.

> Based on data from adecomparison.com by Podium (https://adecomparison.com; source repository https://github.com/madeinorbit/ade-comparison, snapshot 4322f0c of 2026-11-22), used under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Source links and check dates are kept. Podium arranges the findings into pairs, applies its publication checks, and added its own research where marked "Podium team research". Data license terms: https://github.com/madeinorbit/ade-comparison/blob/4322f0c035f303791413639d1462a138443d8c1e/DATA-LICENSE.md

50 of 51 criteria have a sourced finding; 50 were also cross-checked by a second agent. Source checks: 2026-11-16. A missing sourced finding is not evidence that a capability is absent.

- Website: https://github.com/iAmCorey/kooky
- Canonical HTML: https://podium.do/compare/agents/products/kooky/
- Machine-readable JSON: https://podium.do/compare/agents/products/kooky/data.json
- Rubric: https://podium.do/compare/agents/rubric/index.md
- Comparisons with Kooky on podium.do: 1 (listed in the JSON and HTML)
- Compare Kooky with any other product on adecomparison.com by Podium: https://adecomparison.com/compare/?products=kooky

## Access and agent choice

### ACC-01: Client access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Native macOS 14+ desktop app and a kooky-cli control CLI; no Windows, Linux, mobile, browser or editor-extension client.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal), kooky-cli control CLI and kooky-hook agent hook helper; version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=macOS 14+; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- macOS only; review is limited to file-level changed-line counts; no mobile or browser access.

- desktop_os — Desktop os [supported]: macOS 14 (Sonoma) or newer, from the DMG release; Package.swift declares only macOS and release v0.51.12 ships a single DMG, so Windows and Linux are unsupported. Sources: kooky:readme, kooky:pkg, kooky:release.
- mobile_apps — Mobile apps [unsupported]: No iOS or Android app in the release or source. Sources: kooky:release, kooky:srch-clients.
- browser — Browser [unsupported]: No web client in the source. Sources: kooky:srch-clients.
- mobile_browser — Mobile browser [unsupported]: No phone or browser access. Sources: kooky:srch-clients.
- cli — Cli [supported]: kooky-cli opens tabs, resumes conversations, lists, focuses, renames and closes tabs, and reports status. Sources: kooky:readme, kooky:cliproto, kooky:clictl.
- editor_extensions — Editor extensions [unsupported]: No editor extension; the Open in button only hands a directory to other apps. Sources: kooky:srch-clients, kooky:readme.
- task_actions — Task actions [partial]: Start an agent tab from the + menu or CLI, type or compose prompts, answer approvals inside the agent terminal and resume conversations by ID; review is limited to a changed-file list with +/- counts. Sources: kooky:readme, kooky:agents, kooky:gitstatus.
- notifications — Notifications [supported]: macOS notifications and an in-app inbox when an agent waits or a command fails. Sources: kooky:readme, kooky:notif.
- cross_device_continuity — Cross device continuity [unsupported]: State is local to one Mac; no sync or second-device access. Sources: kooky:srch-clients, kooky:persist.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:release, kooky:pkg, kooky:srch-clients, kooky:cliproto, kooky:clictl, kooky:agents, kooky:gitstatus, kooky:notif, kooky:persist

### ACC-02: Agent and model choice

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Fifteen built-in coding CLIs plus any custom command, launched in terminal tabs; Kooky observes them through hooks and process wrappers rather than embedding a harness.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Mixed-harness work is side-by-side tabs; activity and tool-pill detail varies by agent and standalone custom commands have no status dot.

- harnesses — Harnesses [supported]: Claude Code, Codex, Gemini CLI, OpenCode, Amp, Cursor CLI, Copilot CLI, Grok Build, Antigravity CLI, Kimi Code, Pi, Oh My Pi, Reasonix, Kiro CLI and Droid. Sources: kooky:readme, kooky:agents.
- model_providers — Model providers [partial]: Kooky has no provider layer; models are chosen inside each CLI. Claude-based custom agents can set provider endpoint variables. Sources: kooky:customagents, kooky:readme.
- custom_adapters — Custom adapters [supported]: Settings, Agents accepts a name and a command, optionally based on a built-in agent to inherit its launch binary and activity tracking. Sources: kooky:readme, kooky:customagents.
- session_integration — Session integration [supported]: Launches each agent CLI in a shell tab and watches it through lifecycle hooks, a wrapper script and transcript files; it does not embed the harness or call a session API. Sources: kooky:agents, kooky:hookenv, kooky:hooksrv.
- mixed_harness_operation — Mixed harness operation [supported]: Tabs, panes and workspaces can run different agents at once and the agent panel lists them together. Sources: kooky:readme, kooky:agentmon.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:agents, kooky:customagents, kooky:hookenv, kooky:hooksrv, kooky:agentmon

### ACC-03: Subscriptions, API keys and vendor credits

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky starts the real agent CLI, so existing subscription or API logins in the user shell are used as-is; Kooky has no accounts, credits or billing of its own.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Credential handling belongs to each agent CLI; only Claude-based custom agents get a product field for environment variables.

- agent_subscriptions — Agent subscriptions [supported]: Agents run with whatever native login the CLI already has; Kooky does not intercept it. Codex plan type is displayed. Sources: kooky:readme, kooky:codexusage.
- api_accounts — Api accounts [partial]: Claude-based custom agents can carry ANTHROPIC_BASE_URL and token variables; other agents use the user shell environment. Sources: kooky:customagents.
- vendor_credits — Vendor credits [unsupported]: No vendor credits or Kooky account exist. Sources: kooky:readme, kooky:srch-tele.
- local_models — Local models [unsupported]: No local-model feature; a custom command could launch any CLI. Sources: kooky:readme, kooky:customagents.
- account_switching — Account switching [partial]: Separate custom Claude entries can hold different endpoint variables; there is no account switcher. Sources: kooky:customagents.
- vendor_account_requirement — Vendor account requirement [supported]: No account of any kind is required to use Kooky. Sources: kooky:readme.
- provider_restrictions — Provider restrictions [unknown]: Provider restrictions are in the agents' own terms, not in this repository. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:customagents, kooky:codexusage, kooky:srch-tele

### ACC-04: Onboarding and project prerequisites

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Install the DMG, bypass Gatekeeper once (adhoc-signed), open any folder as a workspace and pick an agent from the + menu; works with no Git, local Git and cloned remotes, plus SSH hosts.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Adhoc-signed, not notarized: first launch needs a manual Gatekeeper bypass; no managed cloud; SSH workspaces need a host the user already runs.

- first_task_setup — First task setup [supported]: README Install: download DMG, drag to Applications, bypass Gatekeeper, open a folder, choose an agent from +. Sources: kooky:readme.
- no_git — No git [supported]: Any folder opens as a workspace; git pills appear only inside repositories. Sources: kooky:readme, kooky:gitstatus.
- local_git_without_remote — Local git without remote [supported]: Worktrees, branch switching and diff counts use the local repository only. Sources: kooky:readme, kooky:worktree, kooky:gitstatus.
- hosted_git — Hosted git [supported]: Cloned repositories work like local ones; the repo pill opens the remote on GitHub, GitLab or Bitbucket without any integration login. Sources: kooky:readme.
- prerequisite_guidance — Prerequisite guidance [supported]: README documents macOS 14+, Gatekeeper bypass paths and build prerequisites (Xcode 26+). Sources: kooky:readme.
- managed_cloud_setup — Managed cloud setup [unsupported]: No managed cloud. Sources: kooky:srch-tele, kooky:readme.
- byo_vps_onboarding — Byo vps onboarding [partial]: File, New SSH Workspace attaches a workspace to an existing host; it does not provision or install anything on it. Sources: kooky:readme, kooky:sshsheet, kooky:ssh.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:gitstatus, kooky:worktree, kooky:srch-tele, kooky:sshsheet, kooky:ssh

### ACC-05: Programmable access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

kooky-cli plus kooky:// deep links drive a running app over an owner-only local unix socket; there is no HTTP API, SDK, MCP server or webhook.

Availability: generally-available
Delivery: native
Scope: surfaces=kooky-cli control CLI and kooky-hook agent hook helper, Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Local-only; cannot send input, answer approvals, stop an agent or read diffs; socket protocol is not documented as a public API.

- cli — Cli [supported]: kooky-cli open, resume, list --json, focus, close, rename and status. Sources: kooky:readme, kooky:cliproto, kooky:clicmd.
- api — Api [partial]: The CLI and hooks speak a versioned JSON protocol over a unix socket; it is internal and undocumented as an API. Sources: kooky:cliproto, kooky:hooksrv.
- sdk — Sdk [unsupported]: No SDK in the repository. Sources: kooky:srch-api.
- mcp_server — Mcp server [unsupported]: Kooky does not expose an MCP server. Sources: kooky:srch-api.
- webhooks — Webhooks [unsupported]: No webhooks. Sources: kooky:srch-api.
- operations — Operations [partial]: Create (open, resume), inspect (list, status), focus, rename and close tabs; no steer, approve, stop-agent or review operations. Sources: kooky:readme, kooky:cliproto, kooky:clictl.
- authentication — Authentication [supported]: Commands flow only through a local socket with mode 0600; kooky:// links cannot carry commands. Sources: kooky:hooksrv, kooky:deeplink, kooky:readme.
- stability — Stability [partial]: The envelope carries a protocolVersion and the app refuses newer requests; there is no stability guarantee or deprecation policy. Sources: kooky:cliproto, kooky:clictl.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:cliproto, kooky:clictl, kooky:clicmd, kooky:hooksrv, kooky:srch-api, kooky:deeplink

### ACC-06: External tools and extensions

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky is not an MCP client or plugin host; MCP servers, skills and instruction files belong to each launched agent. Custom agents and Terminal presets are the only extension points.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No product-managed MCP, plugin or skill system; integration setup is inherited entirely from the underlying agent CLI.

- mcp_client — Mcp client [unsupported]: Kooky is not an MCP client; the launched agents manage their own MCP configuration. Sources: kooky:srch-api.
- plugins — Plugins [unsupported]: No plugin API. Sources: kooky:srch-api.
- custom_tools — Custom tools [partial]: Custom agents and Terminal presets add launch entries, not agent tools. Sources: kooky:customagents, kooky:readme.
- instructions_import — Instructions import [unsupported]: Kooky imports no instruction files; agents read their own. Sources: kooky:srch-api.
- authentication — Authentication [unsupported]: No integration authentication in Kooky. Sources: kooky:srch-api.
- permission_scope — Permission scope [unsupported]: No product-level permission scopes for integrations. Sources: kooky:srch-api.
- integration_owner — Integration owner [supported]: Every connection is owned by the launched agent CLI; Kooky only starts it and reads hooks. Sources: kooky:agents, kooky:hookenv.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:customagents, kooky:srch-api, kooky:agents, kooky:hookenv

### ACC-07: Client implementation

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Native macOS app written in Swift with SwiftUI and AppKit views, rendering terminals with the libghostty GPU engine; no web view, Electron or Tauri.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Implementation detail only; says nothing about responsiveness.

- desktop_implementation — Desktop implementation [supported]: Swift package (swift-tools 6.2, macOS 14) with SwiftUI/AppKit and libghostty; README says SwiftUI-native. Sources: kooky:readme, kooky:pkg, kooky:engine.
- mobile_implementation — Mobile implementation [unsupported]: No mobile client. Sources: kooky:srch-clients.
- hybrids — Hybrids [unsupported]: No Electron, Tauri or web hybrid found; terminals are native views over libghostty. Sources: kooky:srch-clients, kooky:engine.
- implementation_evidence — Implementation evidence [supported]: Package.swift targets and the LibghosttyEngine source at the pinned commit. Sources: kooky:pkg, kooky:engine.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:pkg, kooky:engine, kooky:srch-clients

## Planning and context

### PLAN-01: Intake and external tracker relationship

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No task intake or tracker integration; work starts from prompts typed or composed in an agent tab, or from right-click Ask <agent> on selected terminal text.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No issue import, tracker sync or task IDs.

- local_creation — Local creation [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- prompt_intake — Prompt intake [supported]: Prompt composer (Cmd+L) and Ask <agent> on a terminal selection submit a first prompt. Sources: kooky:readme.
- external_import — External import [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- chat_git_triggers — Chat git triggers [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- authoritative_tracker — Authoritative tracker [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- stable_ids — Stable ids [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- sync — Sync [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- supported_edits — Supported edits [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.
- external_roundtrips — External roundtrips [unsupported]: No task or tracker entity; Kooky has no issue integration. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:srch-issues

### PLAN-02: Durable task plans

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No plans, acceptance criteria or revisions; agents keep their own plans.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- plans — Plans [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- acceptance_criteria — Acceptance criteria [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- editors — Editors [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- revisions — Revisions [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- implementation_links — Implementation links [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- amendment — Amendment [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.
- restart_persistence — Restart persistence [unsupported]: No plan feature in Kooky. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-issues

### PLAN-03: Hierarchy, dependencies and evolving scope

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No epics, hierarchy or dependencies; work units are tabs inside folder workspaces.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- epics — Epics [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- hierarchy — Hierarchy [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- blockers — Blockers [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- readiness — Readiness [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- enforcement — Enforcement [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- state_propagation — State propagation [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- task_to_epic — Task to epic [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- identity_retention — Identity retention [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.
- workflow_constraints — Workflow constraints [unsupported]: No hierarchy or dependency model. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-issues

### PLAN-04: Shared context and memory

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky stores no instructions, skills or memory itself; agents load their own. State that survives: workspaces, tabs and resumable conversation IDs on the same Mac.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No shared or correctable memory; only layout and conversation resume persist.

- instructions — Instructions [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- skills — Skills [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- project_docs — Project docs [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- memory — Memory [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- scope — Scope [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- provenance — Provenance [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- correction — Correction [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- deletion — Deletion [partial]: History rows can be hidden; the agents' own conversation data is never touched. Sources: kooky:changelog, kooky:history.
- freshness — Freshness [unsupported]: Kooky has no memory, skill or instruction layer. Sources: kooky:srch-orch.
- takeover_continuity — Takeover continuity [partial]: Workspaces, tabs and agent conversations restore across relaunch on the same machine; no second person can take over. Sources: kooky:persist, kooky:history.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:persist, kooky:history, kooky:srch-orch, kooky:changelog

### PLAN-05: Architecture and API awareness

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No code index or knowledge retrieval; Quick Open searches workspaces, tabs and projects, and pasted screenshots or files are passed to agents as paths.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Quick Open does not search code; multimodal input is just file paths.

- code_search — Code search [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- indexing — Indexing [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- external_knowledge — External knowledge [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- multimodal_inputs — Multimodal inputs [partial]: Pasting or dropping a file or screenshot inserts its path (uploaded first for SSH workspaces). Sources: kooky:readme.
- freshness — Freshness [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- access_scope — Access scope [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- api_retrieval — Api retrieval [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- citations — Citations [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- conflict_detection — Conflict detection [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.
- review_enforcement — Review enforcement [unsupported]: No retrieval or architecture-awareness feature. Sources: kooky:srch-orch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:srch-orch

### PLAN-06: Native issue management and idea backlog

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No issue or idea backlog; workspaces are folders and colour tags only.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- create — Create [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- edit — Edit [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- discuss — Discuss [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- prioritize — Prioritize [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- label — Label [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- assign — Assign [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- search — Search [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- filter — Filter [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- archive — Archive [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- reopen — Reopen [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- project_epic_views — Project epic views [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- idea_parking — Idea parking [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- explicit_dispatch — Explicit dispatch [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- task_session_separation — Task session separation [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- metadata — Metadata [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- durable_states — Durable states [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.
- external_tracker_requirement — External tracker requirement [unsupported]: No native issue entity; sidebar tags only label workspaces. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-issues, kooky:readme

### PLAN-07: Agent-native issue operations

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No issue records for agents to operate; kooky-cli controls tabs only.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- shared_ids — Shared ids [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- read — Read [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- create — Create [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- update — Update [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- claim — Claim [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- assign — Assign [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- state_changes — State changes [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- dependencies — Dependencies [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- children — Children [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- results — Results [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- human_visibility — Human visibility [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- attribution — Attribution [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- permissions — Permissions [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.
- conflicts — Conflicts [unsupported]: No shared issue records or agent-writable fields. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-issues, kooky:cliproto

### PLAN-08: Living product specifications

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No persistent product specification feature.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- persistent_requirements — Persistent requirements [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- human_edits — Human edits [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- agent_edits — Agent edits [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- revisions — Revisions [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- approvals — Approvals [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- implementation_links — Implementation links [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- later_retrieval — Later retrieval [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- drift_detection — Drift detection [unsupported]: No living-spec feature. Sources: kooky:srch-issues.
- review_integration — Review integration [unsupported]: No living-spec feature. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-issues

## Coordination and automation

### COORD-01: Parallel work

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Any number of tabs, panes and windows run agents concurrently, each in its own PTY; the agent panel shows waiting, failed, running and idle across windows.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No task entity and no documented quota; concurrency measurements are not published.

- concurrent_sessions — Concurrent sessions [supported]: Independent terminal sessions run in parallel across tabs, splits and windows. Sources: kooky:readme, kooky:agentmon.
- concurrent_tasks — Concurrent tasks [unsupported]: No task entity; the unit is a session. Sources: kooky:srch-issues.
- quotas — Quotas [unsupported]: No quota or concurrency cap found in the app source. Sources: kooky:srch-orch.
- observed_concurrency — Observed concurrency [unknown]: No published concurrency measurements. Sources: kooky:readme.
- status_visibility — Status visibility [supported]: Sidebar dots and the agent panel show running (blue), waiting (amber), idle and failed (red) states. Sources: kooky:readme, kooky:agentmon.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:agentmon, kooky:srch-issues, kooky:srch-orch

### COORD-02: Ownership and dispatch

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No assignment, claims or queues; each tab is a user-started session.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- human_assignment — Human assignment [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- agent_assignment — Agent assignment [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- claims — Claims [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- queues — Queues [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- routing — Routing [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- duplicate_prevention — Duplicate prevention [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.
- ownership_enforcement — Ownership enforcement [unsupported]: No ownership or dispatch features. Sources: kooky:srch-orch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-orch

### COORD-03: Inspectable delegation and communication

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No product coordinator or delegation; agents may use their own subagent features, which Kooky does not model. kooky-cli can open tabs for scripts.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- kooky-cli opens and resumes tabs but lets no agent read another agent's output or message it.

- roles — Roles [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- model_harness_effort — Model harness effort [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- messages — Messages [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- results_return — Results return [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- cross_harness — Cross harness [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- orchestration_owner — Orchestration owner [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- activation — Activation [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- authentication — Authentication [supported]: Local owner-only socket; no credentials. Sources: kooky:hooksrv.
- live_progress — Live progress [unsupported]: No delegation or inter-agent messaging in Kooky. Sources: kooky:srch-orch.
- retained_results — Retained results [partial]: Session history lists past conversations from agent transcripts and can resume them. Sources: kooky:history.
- followup — Followup [partial]: A completed conversation can be resumed from history or by kooky://resume. Sources: kooky:history, kooky:deeplink.
- invocation — Invocation [partial]: A script or agent could call kooky-cli open --agent to start another tab, a generic command rather than a coordinator role. Sources: kooky:readme, kooky:cliproto.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-orch, kooky:cliproto, kooky:hooksrv, kooky:history, kooky:deeplink, kooky:readme

### COORD-04: Unattended triggers

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No scheduler or event triggers; kooky-cli could be called by an external scheduler the user sets up.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- schedules — Schedules [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- events — Events [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- recurring_tasks — Recurring tasks [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- completion_conditions — Completion conditions [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- scheduler_location — Scheduler location [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- overlaps — Overlaps [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- retries — Retries [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.
- client_independence — Client independence [unsupported]: No scheduler or trigger in Kooky. Sources: kooky:srch-sched.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-sched, kooky:readme

### COORD-05: Intervention and attention

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Steer by typing in the agent terminal or the prompt composer; closing a tab stops it; waiting agents raise notifications and amber dots. No pause, no escalation.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No pause or escalation; stop is closing the tab; pending decisions are answered inside the agent TUI.

- pause — Pause [unsupported]: No pause control beyond the terminal itself. Sources: kooky:srch-orch.
- stop — Stop [supported]: Closing a tab terminates its foreground process group after a bounded grace period, with an optional confirm-close setting. Sources: kooky:readme, kooky:changelog.
- resume — Resume [supported]: Conversations resume by exact session ID after relaunch or from history. Sources: kooky:readme, kooky:history.
- steer — Steer [supported]: Type into the terminal or the Cmd+L prompt composer. Sources: kooky:readme.
- notifications — Notifications [supported]: macOS notifications plus an inbox for waiting agents and failed commands. Sources: kooky:readme, kooky:notif.
- pending_decisions — Pending decisions [partial]: A waiting dot (including pending tool approval) flags it; the decision itself is made inside the agent. Sources: kooky:readme, kooky:agentmon.
- escalation — Escalation [unsupported]: No escalation or routing. Sources: kooky:srch-orch.
- visible_errors — Visible errors [supported]: Tabs and workspaces turn red when the last command exits non-zero, with exit code and duration on hover. Sources: kooky:readme.
- chat_terminal_parity — Chat terminal parity [supported]: The terminal is the only surface, so there is nothing to diverge. Sources: kooky:readme.
- retained_history — Retained history [partial]: Agent conversation history is browsable and resumable; scrollback is lost on quit. Sources: kooky:history, kooky:persist.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:notif, kooky:agentmon, kooky:srch-orch, kooky:changelog, kooky:history, kooky:persist

### COORD-06: Fleet and epic management UI

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

The agent panel and sidebar show every agent and workspace across windows ordered by attention; there are no epics, dependencies or workload view.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No parent/child, dependency or workload views.

- fleet_fixture — Fleet fixture [supported]: Agent panel lists all agents with state across windows sorted waiting, failed, running, idle. Sources: kooky:agentmon, kooky:readme.
- parent_child — Parent child [unsupported]: No epics or dependency graph. Sources: kooky:srch-issues.
- dependencies — Dependencies [unsupported]: No epics or dependency graph. Sources: kooky:srch-issues.
- attention — Attention [supported]: Waiting agents sort first and carry amber dots and notifications. Sources: kooky:readme, kooky:agentmon.
- history — History [partial]: Session history lists past conversations; no per-fleet timeline. Sources: kooky:history.
- workload — Workload [unsupported]: No epics or dependency graph. Sources: kooky:srch-issues.
- navigation_errors — Navigation errors [supported]: Clicking a row jumps to the tab; failed commands show red dots and inbox entries. Sources: kooky:readme, kooky:agentmon.
- fixture_mode — Fixture mode [unsupported]: Not applicable; there is no fixture mode. Sources: kooky:srch-issues.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:agentmon, kooky:srch-issues, kooky:history

### COORD-07: Workflow flexibility and orchestration visibility

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Opening an agent is one click from the + menu with no preset; Settings configures agents, Terminal presets and launch options, with no natural-language setup or role UI.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No growth path from a quick task to a structured effort; no role views.

- quick_task — Quick task [supported]: Pick an agent from + and start; the agent boots before the first prompt prints. Sources: kooky:readme.
- growing_epic — Growing epic [unsupported]: No workflow or orchestration layer. Sources: kooky:srch-orch.
- presets — Presets [partial]: Terminal presets (pinned directory) and per-agent launch options exist; no workflow presets. Sources: kooky:readme, kooky:customagents.
- natural_language — Natural language [unsupported]: No workflow or orchestration layer. Sources: kooky:srch-orch.
- agent_configuration — Agent configuration [partial]: Custom agents can add launch options and environment; model and effort are set inside the agent. Sources: kooky:customagents.
- in_run_changes — In run changes [partial]: The user can type into the running agent; Kooky offers no run-level change. Sources: kooky:readme.
- live_roles — Live roles [unsupported]: No workflow or orchestration layer. Sources: kooky:srch-orch.
- retained_relationships — Retained relationships [unsupported]: No workflow or orchestration layer. Sources: kooky:srch-orch.
- discoverability — Discoverability [supported]: The + menu and Quick Open list every agent and preset. Sources: kooky:readme.
- auth_friction — Auth friction [supported]: No Kooky login; existing agent logins apply. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:agents, kooky:srch-orch, kooky:customagents

## Execution and reliability

### RUN-01: Laptop-independent execution

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Agents run locally on the Mac or, for SSH workspaces, inside plain ssh sessions on a host the user controls; Kooky has no managed or hosted execution.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=local, own-server; region=not specified; harness=not specified.

Limitations:
- SSH tabs are live ssh connections, not detached remote sessions; there is no vendor cloud and no provisioning.

- local — Local [supported]: Default mode: agents run in local PTYs. Sources: kooky:readme, kooky:engine.
- byo_remote — Byo remote [partial]: SSH workspaces start tabs and agents on a user-owned host via ssh with shared ControlMaster connections. Sources: kooky:readme, kooky:ssh, kooky:sshsheet.
- self_hosted — Self hosted [unsupported]: No self-hosted service component exists. Sources: kooky:srch-tele.
- managed_cloud — Managed cloud [unsupported]: No managed cloud. Sources: kooky:srch-tele.
- hybrid — Hybrid [partial]: Local and SSH workspaces can be open side by side. Sources: kooky:readme.
- provisioning — Provisioning [unsupported]: Kooky does not provision remote hosts. Sources: kooky:sshsheet.
- payer — Payer [supported]: The user pays for their own machines and agent subscriptions; Kooky is free. Sources: kooky:readme, kooky:license.
- resources — Resources [unsupported]: Kooky sets no compute resources. Sources: kooky:srch-container.
- region — Region [unsupported]: No regions; no hosted service. Sources: kooky:srch-tele.
- expiry — Expiry [unsupported]: No lifetime limits; sessions end with the ssh connection or app. Sources: kooky:ssh, kooky:persist.
- client_disconnect — Client disconnect [unsupported]: A plain ssh session ends when the connection or the app ends; keep-awake only stops the Mac sleeping. Sources: kooky:ssh, kooky:sleep.
- other_device_continuation — Other device continuation [unsupported]: No second-device access. Sources: kooky:srch-clients.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:ssh, kooky:srch-tele, kooky:engine, kooky:sshsheet, kooky:license, kooky:srch-container, kooky:persist, kooky:sleep, kooky:srch-clients

### RUN-02: Workspace and process isolation

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Git worktrees on request (Create Worktree creates a branch folder nested under its repo); otherwise agents share the opened folder. No container, VM or OS sandbox.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- A worktree separates files only; agents run as the user with full access.

- checkout — Checkout [supported]: Default workspace is the opened folder, shared by all its tabs. Sources: kooky:readme.
- branch — Branch [supported]: Worktree creation targets a new or existing branch. Sources: kooky:readme, kooky:worktree.
- worktree — Worktree [supported]: Create Worktree, adopt mode and optional removal with branch delete. Sources: kooky:readme, kooky:worktree.
- container — Container [unsupported]: No container isolation. Sources: kooky:srch-container.
- vm — Vm [unsupported]: No VM isolation. Sources: kooky:srch-container.
- os_sandbox — Os sandbox [unsupported]: No OS sandbox; only macOS secure keyboard input and clipboard confirmation. Sources: kooky:srch-container, kooky:secure, kooky:clip.
- filesystem — Filesystem [unsupported]: No filesystem boundary beyond worktree folders. Sources: kooky:srch-container.
- process — Process [unsupported]: No process boundary; agents are child processes of the user shell. Sources: kooky:srch-container, kooky:agents.
- network — Network [unsupported]: No network boundary. Sources: kooky:srch-container.
- secrets — Secrets [partial]: Custom agent environment variables stay out of the shell export for Claude entries, via a settings file; no secret isolation. Sources: kooky:customagents.
- code_separation — Code separation [partial]: Worktrees keep branches separate on disk. Sources: kooky:worktree.
- security_boundary — Security boundary [unsupported]: None; a worktree is not a security boundary. Sources: kooky:srch-container.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:worktree, kooky:srch-container, kooky:secure, kooky:clip, kooky:agents, kooky:customagents

### RUN-03: Recovery, expiry and continuity

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Layout, cwd, worktree and SSH-host metadata restore on relaunch and agent conversations resume by exact session ID; scrollback and running processes cannot survive quit.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Processes and scrollback are lost on quit or disconnect; resume depends on each agent CLI.

- client_disconnect — Client disconnect [partial]: There is no separate client; SSH tabs end when the connection drops and reconnect on next spawn. Sources: kooky:ssh, kooky:persist.
- worker_crash — Worker crash [unsupported]: No worker process model; a crash writes a local stderr log only. Sources: kooky:crash.
- service_restart — Service restart [unsupported]: No service. Sources: kooky:srch-tele.
- expiry — Expiry [unsupported]: No sandbox expiry. Sources: kooky:srch-container.
- transcript_reload — Transcript reload [partial]: Agent history can be re-read and resumed; Kooky scrollback is not persisted. Sources: kooky:history, kooky:persist.
- process_reconnect — Process reconnect [unsupported]: Processes cannot be reattached after quit; panes respawn. Sources: kooky:persist.
- task_resume — Task resume [supported]: Agents resume their exact conversation after relaunch or from history. Sources: kooky:readme, kooky:history, kooky:changelog.
- state_reconstruction — State reconstruction [supported]: state.json rebuilds windows, panes, workspaces, worktrees and SSH hosts. Sources: kooky:persist.
- context_loss — Context loss [partial]: Terminal scrollback and unsaved shell input are lost; agent context returns through resume. Sources: kooky:persist.
- duplicate_actions — Duplicate actions [unsupported]: No documented guard against agent repeating actions after resume. Sources: kooky:history.
- manual_repair — Manual repair [partial]: Users reopen missing worktrees or SSH hosts; entries whose directory is gone are cleaned at launch. Sources: kooky:readme.
- multi_day_continuity — Multi day continuity [partial]: Conversations resume from agent transcripts on the same Mac, with no compute replacement concept. Sources: kooky:history.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:persist, kooky:history, kooky:changelog, kooky:ssh, kooky:crash, kooky:srch-tele, kooky:srch-container, kooky:readme

### RUN-04: Development environment reliability

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky does not install dependencies or manage services; the status bar shows Node, Python venv, proxy and branch state and can switch Node versions and branches.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No caches, snapshots, services or port allocation.

- dependencies — Dependencies [partial]: Status bar detects Node and venv and can run a Node version switch in the shell. Sources: kooky:readme, kooky:fileinfo.
- caches — Caches [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- snapshots — Snapshots [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- services — Services [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- ports — Ports [partial]: Session Info lists a tab's listening ports and opens them in a browser; nothing allocates ports. Sources: kooky:fileinfo.
- secrets — Secrets [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- duplicate_installs — Duplicate installs [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- collisions — Collisions [unsupported]: No environment provisioning in Kooky. Sources: kooky:srch-container.
- remote_setup — Remote setup [partial]: SSH agents start with the remote shell setup loaded so nvm-installed tools resolve. Sources: kooky:readme, kooky:ssh.
- automatic_repair — Automatic repair [unsupported]: No automatic repair. Sources: kooky:srch-container.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:fileinfo, kooky:srch-container, kooky:ssh

### RUN-05: Limits and failure handling

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No time, turn, token or spend limits; Codex rate-limit percentages are displayed only.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Display of Codex limits is read-only.

- time_limits — Time limits [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.
- turn_limits — Turn limits [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.
- token_limits — Token limits [partial]: Codex 5-hour and weekly rate-limit percentages are shown. Sources: kooky:codexusage.
- spend_limits — Spend limits [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.
- timeouts — Timeouts [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.
- retries — Retries [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.
- provider_failures — Provider failures [unsupported]: Provider failures are visible only in the agent terminal. Sources: kooky:srch-cost.
- enforcement — Enforcement [unsupported]: No limit enforcement in Kooky. Sources: kooky:srch-cost.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:codexusage, kooky:srch-cost

### RUN-06: Truthful status and operational statistics

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Sidebar and agent-panel states, exit codes with durations, a Session Info inspector and a tool pill for supported agents; no usage export or statistics.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No per-task or per-agent statistics or exports; only local stderr log.

- logs — Logs [partial]: A local stderr log at ~/Library/Logs/kooky; terminal output is not logged. Sources: kooky:crash.
- traces — Traces [partial]: A tool pill shows the running tool and elapsed time; full tool history opens on click. Sources: kooky:readme.
- failure_reasons — Failure reasons [partial]: Non-zero exit code and duration on hover; agent errors appear in the terminal. Sources: kooky:readme, kooky:fileinfo.
- usage_export — Usage export [unsupported]: No usage export. Sources: kooky:srch-cost.
- task_stats — Task stats [unsupported]: No task statistics. Sources: kooky:srch-cost.
- agent_stats — Agent stats [unsupported]: No agent statistics. Sources: kooky:srch-cost.
- project_stats — Project stats [unsupported]: No project statistics. Sources: kooky:srch-cost.
- time_stats — Time stats [unsupported]: No time statistics. Sources: kooky:srch-cost.
- failure_status — Failure status [supported]: Red dots for last command failure; failed tool calls turn red. Sources: kooky:readme.
- approval_status — Approval status [supported]: Amber waiting dot covers pending tool approvals for hooked agents. Sources: kooky:readme.
- reconnect_consistency — Reconnect consistency [partial]: State is rebuilt from the saved layout and agent hooks on relaunch. Sources: kooky:persist.
- performance_method — Performance method [unknown]: No benchmark method in the repository beyond a bench script. Sources: kooky:readme.
- responsiveness — Responsiveness [unknown]: No published responsiveness measurements. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:fileinfo, kooky:agentmon, kooky:crash, kooky:srch-cost, kooky:persist

### RUN-07: Per-task API and compute cost

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No cost tracking; for Codex the status bar shows rate-limit usage and context occupancy.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No dollar or token cost for any agent; Codex gauge only.

- task_cost — Task cost [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- session_cost — Session cost [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- child_cost — Child cost [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- epic_cost — Epic cost [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- harness_aggregation — Harness aggregation [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- billed_vs_estimated — Billed vs estimated [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- tokens — Tokens [partial]: Codex context-window occupancy in tokens is shown. Sources: kooky:codexusage.
- subscription_allowance — Subscription allowance [partial]: Codex 5-hour and weekly allowance percentages and plan type. Sources: kooky:codexusage.
- provider_reconciliation — Provider reconciliation [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- compute_cost — Compute cost [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- refresh_delay — Refresh delay [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- alerts — Alerts [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- export — Export [unsupported]: No cost tracking. Sources: kooky:srch-cost.
- drilldown — Drilldown [unsupported]: No cost tracking. Sources: kooky:srch-cost.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:codexusage, kooky:srch-cost

### RUN-08: Compute-aware scheduling and verification

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No compute-aware scheduling, queues or limits; background tabs pause rendering to save GPU only.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- concurrency — Concurrency [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- queues — Queues [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- cpu_ram — Cpu ram [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- backpressure — Backpressure [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- host_awareness — Host awareness [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- check_reuse — Check reuse [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- check_deduplication — Check deduplication [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- bounded_tests — Bounded tests [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- cancellation — Cancellation [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- fairness — Fairness [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- recovery — Recovery [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.
- shared_limits — Shared limits [unsupported]: No scheduling or resource-limit feature. Sources: kooky:srch-orch.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-orch, kooky:changelog

## Human collaboration and control

### TEAM-01: Live human collaboration

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

Single-user local app; no sharing, comments or presence.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- visibility — Visibility [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- discussion — Discussion [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- comments — Comments [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- presence — Presence [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- coprompting — Coprompting [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- ordering — Ordering [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- conflicts — Conflicts [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- attribution — Attribution [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- permissions — Permissions [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- plan_restrictions — Plan restrictions [unsupported]: No multi-user feature. Sources: kooky:srch-team.
- owner_online — Owner online [unsupported]: No multi-user feature. Sources: kooky:srch-team.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-team, kooky:readme

### TEAM-02: Roles and access boundaries

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No roles, SSO or membership; the app has no accounts.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- organization_roles — Organization roles [unsupported]: No account or role system. Sources: kooky:srch-team.
- project_roles — Project roles [unsupported]: No account or role system. Sources: kooky:srch-team.
- task_roles — Task roles [unsupported]: No account or role system. Sources: kooky:srch-team.
- membership — Membership [unsupported]: No account or role system. Sources: kooky:srch-team.
- sso — Sso [unsupported]: No account or role system. Sources: kooky:srch-team.
- provisioning — Provisioning [unsupported]: No account or role system. Sources: kooky:srch-team.
- unauthorized_access — Unauthorized access [unsupported]: No account or role system. Sources: kooky:srch-team.
- revocation — Revocation [unsupported]: No account or role system. Sources: kooky:srch-team.
- plan_scope — Plan scope [unsupported]: No account or role system. Sources: kooky:srch-team.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-team, kooky:readme

### TEAM-03: Approvals and temporary access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No Kooky approval system; agents ask in their own terminals and Kooky flags the wait. Product-side guards cover risky paste and clipboard access only.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Command and tool approvals are not product-enforced; defaults are whatever each agent allows.

- command — Command [partial]: Multi-line paste outside bracketed paste asks for confirmation with a preview. Sources: kooky:readme, kooky:clip.
- tool — Tool [partial]: Pending tool approvals are surfaced as a waiting dot; the agent enforces them. Sources: kooky:readme.
- network — Network [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.
- secret — Secret [partial]: macOS secure keyboard input is held during sudo or ssh password entry. Sources: kooky:readme, kooky:secure.
- delivery — Delivery [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.
- approver_identity — Approver identity [unsupported]: Single user. Sources: kooky:srch-team.
- lifetime — Lifetime [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.
- allow — Allow [partial]: Clipboard-write and OSC 52 read prompts offer allow. Sources: kooky:readme, kooky:clip.
- deny — Deny [partial]: Same prompts offer deny. Sources: kooky:readme, kooky:clip.
- revoke — Revoke [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.
- tunnels — Tunnels [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.
- defaults — Defaults [partial]: Agents run with their own default permissions. Sources: kooky:agents.
- safer_modes — Safer modes [partial]: Optional confirm-close-surface and clipboard-write = ask settings. Sources: kooky:readme.
- enforcement — Enforcement [unsupported]: No product-level approval or access policy. Sources: kooky:srch-team.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:clip, kooky:secure, kooky:srch-team, kooky:agents

### TEAM-04: Decision and activity history

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No attributed activity history; the notification inbox and agent session history are local single-user records.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Local, mutable, single-user lists.

- actions — Actions [partial]: Notification inbox keeps who waited, what failed and what finished. Sources: kooky:readme.
- approvals — Approvals [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- edits — Edits [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- discussion — Discussion [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- decisions — Decisions [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- cross_user_persistence — Cross user persistence [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- cross_session_persistence — Cross session persistence [partial]: Agent conversation history persists in each agent's own files. Sources: kooky:history.
- export — Export [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- mutability — Mutability [partial]: Users can hide history rows; transcripts belong to the agents. Sources: kooky:changelog, kooky:history.
- retention — Retention [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.
- integrity — Integrity [unsupported]: No audit or attribution feature. Sources: kooky:srch-team.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:history, kooky:srch-team, kooky:changelog

### TEAM-05: Review experience and guidance

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Review is a changed-files popover with +/- counts per file, a file tree with change counts and open-in-editor handoff; no diff viewer, comments or request-changes flow.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No line-level diff, comments or guided review.

- pending_reviews — Pending reviews [partial]: Diff pill shows files changed in the current tab's repository. Sources: kooky:gitstatus.
- change_understanding — Change understanding [partial]: Per-file insertions and deletions only. Sources: kooky:gitstatus.
- evidence_navigation — Evidence navigation [partial]: Show in File Tree and open file in preferred editor. Sources: kooky:gitstatus, kooky:readme.
- comments — Comments [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- request_changes — Request changes [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- shipping_guidance — Shipping guidance [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- effort — Effort [unknown]: Review effort is a usability measure not documented. Sources: kooky:readme.
- missed_evidence — Missed evidence [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- keyboard — Keyboard [partial]: Many shortcuts exist; review-specific keyboard flows do not. Sources: kooky:readme.
- narrow_screen — Narrow screen [unsupported]: Desktop-only layout. Sources: kooky:srch-clients.
- context_switching — Context switching [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- roles — Roles [unsupported]: No review workflow in Kooky. Sources: kooky:srch-pr.
- retained_context — Retained context [partial]: Panes keep their state until quit. Sources: kooky:persist.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:gitstatus, kooky:readme, kooky:srch-pr, kooky:srch-clients, kooky:persist

### TEAM-06: Colleague takeover and continuity

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No takeover; one local user, and an SSH workspace or kooky:// link is not a handoff.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- ongoing_takeover — Ongoing takeover [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- same_task — Same task [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- session_history — Session history [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- decisions — Decisions [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- artifacts — Artifacts [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- permissions — Permissions [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- runtime_context — Runtime context [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- owner_disconnect — Owner disconnect [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- ownership — Ownership [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- attribution — Attribution [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- context_loss — Context loss [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.
- harness_transfer — Harness transfer [unsupported]: No colleague or second-device takeover. Sources: kooky:srch-team.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-team, kooky:persist

## Verification and delivery

### SHIP-01: Retained artifacts and outputs

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky retains only agent transcripts through history and a changed-file list; no screenshots, recordings, previews, gallery or test outputs.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- No artifact gallery; outputs live in the agents and the working tree.

- diffs — Diffs [partial]: Changed-file counts only, no diff content. Sources: kooky:gitstatus.
- documents — Documents [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- screenshots — Screenshots [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- recordings — Recordings [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- previews — Previews [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- test_outputs — Test outputs [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- reviewer_outputs — Reviewer outputs [partial]: Past agent conversations can be reopened from history. Sources: kooky:history.
- gallery — Gallery [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- task_links — Task links [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- revision_links — Revision links [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- persistence — Persistence [partial]: Conversation transcripts persist in agent directories. Sources: kooky:history.
- child_findings — Child findings [unsupported]: No artifact retention feature. Sources: kooky:srch-pr.
- prompt_leakage — Prompt leakage [unknown]: Not documented in the repository. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:gitstatus, kooky:history, kooky:srch-pr, kooky:readme

### SHIP-02: Verification and spec gates

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No test, lint, type, CI or review gates in Kooky; its own repository runs swift test locally.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- tests — Tests [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- lint — Lint [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- types — Types [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- ci — Ci [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- independent_review — Independent review [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- spec_checks — Spec checks [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- required_checks — Required checks [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- failure_blocking — Failure blocking [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- requirement_conflicts — Requirement conflicts [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- configured_policy — Configured policy [unsupported]: No verification gate feature. Sources: kooky:srch-pr.
- enforced_policy — Enforced policy [unsupported]: No verification gate feature. Sources: kooky:srch-pr.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-pr, kooky:readme

### SHIP-03: Git and pull request workflow

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Worktree creation on new or existing branches, branch switching from the status bar and live diff counts; no commit, PR, rebase or conflict handling.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Git state is shown and branches and worktrees are managed; commits, PRs and rebases are left to the agent or user.

- branches — Branches [supported]: Click the branch pill to switch branches; worktrees can target new or existing branches. Sources: kooky:readme, kooky:worktree.
- worktrees — Worktrees [supported]: Create, adopt and remove worktrees nested in the sidebar. Sources: kooky:readme, kooky:worktree.
- commits — Commits [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- pull_requests — Pull requests [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- comments — Comments [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- ci_response — Ci response [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- rebase — Rebase [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- conflicts — Conflicts [unsupported]: No product git workflow beyond branches and worktrees. Sources: kooky:srch-pr.
- product_state — Product state [partial]: Sidebar nests worktrees under their source workspace and diff counts update live. Sources: kooky:readme, kooky:gitstatus.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:worktree, kooky:gitstatus, kooky:srch-pr

### SHIP-04: Merge and deployment authority

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No approval, merge, release or deploy authority in Kooky.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- approve — Approve [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.
- merge — Merge [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.
- release — Release [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.
- deploy — Deploy [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.
- exact_revision — Exact revision [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.
- authority_enforcement — Authority enforcement [unsupported]: No delivery authority feature. Sources: kooky:srch-pr.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-pr

### SHIP-05: Completion evidence and rollback

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No delivery links, completion evidence or rollback; the repo pill opens the remote repository page.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- commit_links — Commit links [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- pr_links — Pr links [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- build_links — Build links [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- deployment_links — Deployment links [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- delivery_status — Delivery status [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- retained_evidence — Retained evidence [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- rollback — Rollback [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- revert — Revert [unsupported]: No delivery tracking. Sources: kooky:srch-pr.
- stale_approval_invalidation — Stale approval invalidation [unsupported]: No delivery tracking. Sources: kooky:srch-pr.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-pr, kooky:readme

### SHIP-06: Batch review and high-volume shipping

Verification status: Agent cross-checked (agent-cross-checked)
Support: unsupported

No review queue or batch delivery.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

- review_queue — Review queue [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- summaries — Summaries [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- grouping — Grouping [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- risk_size_filters — Risk size filters [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- findings — Findings [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- artifacts — Artifacts [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- request_changes — Request changes [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- exact_revision_approval — Exact revision approval [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- dependency_queues — Dependency queues [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- next_actions — Next actions [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- stale_approval_invalidation — Stale approval invalidation [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.
- check_deduplication — Check deduplication [unsupported]: No batch review or delivery queue. Sources: kooky:srch-pr.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:srch-pr

## Ownership, privacy and economics

### OWN-01: Source and license

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

MIT-licensed application source in one public repository; bundled fonts and theme palettes keep their own licenses; libghostty is linked as a dependency.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Bundled third-party assets retain upstream licenses.

- client_license — Client license [supported]: MIT; copyright 2026 kooky contributors. Sources: kooky:license, kooky:readme.
- server_license — Server license [unsupported]: No server component exists. Sources: kooky:srch-tele.
- hosted_extensions — Hosted extensions [unsupported]: No hosted extension exists. Sources: kooky:srch-tele.
- source_visibility — Source visibility [supported]: Public GitHub repository with the full app, CLI and hook helper. Sources: kooky:readme, kooky:repoapi.
- source_revision — Source revision [supported]: Pinned to release v0.51.12, commit fc54bd9. Sources: kooky:release, kooky:repoapi.
- hosted_parity — Hosted parity [unsupported]: No hosted product exists to compare. Sources: kooky:srch-tele.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:license, kooky:readme, kooky:notice, kooky:release, kooky:srch-tele, kooky:repoapi

### OWN-02: Hosting and exit

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

The whole app runs on the user Mac with no required vendor service; state is a local state.json and settings.json; source is MIT.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- State and history are local files, not an interchange format; no hosted account exists.

- self_hosting — Self hosting [supported]: All components run locally with no vendor service; the only call is a manual update check. Sources: kooky:readme, kooky:update.
- vendor_dependencies — Vendor dependencies [supported]: None required; the optional update check calls GitHub. Sources: kooky:update.
- export — Export [partial]: Settings and state are plain JSON files; there is no export feature. Sources: kooky:persist.
- import — Import [partial]: Existing Ghostty config and theme files are inherited. Sources: kooky:readme.
- formats — Formats [partial]: state.json and settings.json, Ghostty-style theme files. Sources: kooky:persist, kooky:readme.
- cancellation — Cancellation [unsupported]: No account exists to cancel. Sources: kooky:srch-tele.
- account_independence — Account independence [supported]: Everything works without any account. Sources: kooky:readme.
- history_portability — History portability [partial]: Agent conversations stay in each agent's own directories and can be resumed by deep link. Sources: kooky:history, kooky:deeplink.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:persist, kooky:update, kooky:srch-tele, kooky:history, kooky:deeplink

### OWN-03: Data handling and telemetry

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

README states no accounts, no telemetry and no cloud sync; the only network call found is a manual GitHub release check; prompts and code go from the user terminal to whichever agent provider they use.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Provider data handling is each agent vendor's policy; absence of a code path does not prove nothing leaves other processes.

- code_data — Code data [supported]: Code and prompts stay on the Mac except where the launched agent sends them. Sources: kooky:readme, kooky:srch-tele.
- prompts — Prompts [supported]: Prompts go from the terminal to the agent CLI; Kooky stores none. Sources: kooky:readme, kooky:history.
- credentials — Credentials [supported]: Kooky holds no credentials; custom environment values live in local settings. Sources: kooky:customagents.
- logs — Logs [supported]: A local stderr log only. Sources: kooky:crash.
- artifacts — Artifacts [supported]: Local state.json and settings.json. Sources: kooky:persist.
- retention — Retention [partial]: Local files remain until the user deletes them; no policy. Sources: kooky:persist.
- deletion — Deletion [partial]: Hidden history rows only hide; the user deletes local files manually. Sources: kooky:changelog.
- training — Training [unknown]: Kooky has no model; training use belongs to the agent providers. Sources: kooky:readme.
- residency — Residency [unknown]: Provider-specific. Sources: kooky:readme.
- subprocessors — Subprocessors [unknown]: Kooky has no vendor service; provider subprocessors are outside the repository. Sources: kooky:readme.
- telemetry_disclosure — Telemetry disclosure [supported]: README: no accounts, no telemetry; bounded search found no analytics client. Sources: kooky:readme, kooky:srch-tele.
- telemetry_defaults — Telemetry defaults [supported]: No telemetry exists, so none is on by default. Sources: kooky:srch-tele.
- telemetry_controls — Telemetry controls [unsupported]: No telemetry control, because nothing is collected. Sources: kooky:srch-tele.
- consent_prompt — Consent prompt [unsupported]: No consent prompt; none is needed. Sources: kooky:srch-tele.
- provider_separation — Provider separation [supported]: Orchestration (none) and model-provider data flow are separate because Kooky never calls providers. Sources: kooky:update, kooky:srch-tele.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:update, kooky:srch-tele, kooky:crash, kooky:history, kooky:customagents, kooky:persist, kooky:changelog

### OWN-04: Price and included usage

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Free open-source app with no price, tiers, seats or credits; agent subscriptions and API usage are paid separately to providers.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Provider costs are outside the product and not estimated.

- currency — Currency [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- interval — Interval [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- seats — Seats [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- seat_minimum — Seat minimum [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- workspace_fees — Workspace fees [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- included_usage — Included usage [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- credits — Credits [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- trial — Trial [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- overages — Overages [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- taxes — Taxes [unsupported]: No prices or billing exist in Kooky. Sources: kooky:srch-cost, kooky:readme.
- model_cost — Model cost [partial]: Paid to the agent providers directly; not shown. Sources: kooky:readme.
- compute_cost — Compute cost [partial]: Own Mac or SSH host; no fee. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:license, kooky:srch-cost

### OWN-05: Scenario cost and controls

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Kooky platform cost is zero for any team size; agent subscription or API cost is not estimated.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Agent costs are unknown and not modelled.

- one_person — One person [partial]: Platform fee zero; agent cost excluded. Sources: kooky:readme, kooky:license.
- two_people — Two people [partial]: Platform fee zero; agent cost excluded. Sources: kooky:readme, kooky:license.
- five_people — Five people [partial]: Platform fee zero; agent cost excluded. Sources: kooky:readme, kooky:license.
- task_assumptions — Task assumptions [unsupported]: No scenario costing; no fee exists. Sources: kooky:readme.
- concurrency — Concurrency [unsupported]: No scenario costing; no fee exists. Sources: kooky:readme.
- tokens — Tokens [unsupported]: No scenario costing; no fee exists. Sources: kooky:readme.
- compute_hours — Compute hours [unsupported]: No scenario costing; no fee exists. Sources: kooky:readme.
- fixed_cost — Fixed cost [supported]: No Kooky fixed cost. Sources: kooky:readme.
- variable_cost — Variable cost [unsupported]: No scenario costing; no fee exists. Sources: kooky:readme.
- included_cost — Included cost [supported]: No included usage. Sources: kooky:readme.
- unknown_cost — Unknown cost [supported]: Agent and compute costs are outside the product and unknown. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:license

### OWN-06: Availability and support

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Generally available open-source release from a single maintainer-led repository with regular releases through 2026-10-12; support via GitHub issues and discussions; no commitments.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Adhoc-signed builds; no support SLA; one maintainer wrote nearly all commits.

- release_stage — Release stage [supported]: Public releases through v0.51.12 (pre-1.0 numbering). Sources: kooky:release, kooky:changelog.
- access_restrictions — Access restrictions [supported]: Free download; adhoc-signed so Gatekeeper needs a manual bypass. Sources: kooky:readme.
- support — Support [partial]: GitHub issues, discussions and a sponsorship link. Sources: kooky:issues, kooky:repoapi.
- response_commitments — Response commitments [unknown]: None published. Sources: kooky:readme.
- release_activity — Release activity [supported]: Releases through v0.51.12 dated 2026-10-12 and a default-branch push the same day. Sources: kooky:release, kooky:changelog, kooky:repoapi.
- status_history — Status history [unknown]: No status page. Sources: kooky:readme.
- deprecation — Deprecation [unsupported]: No deprecation policy. Sources: kooky:readme.
- export_options — Export options [partial]: Local JSON files. Sources: kooky:persist.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:release, kooky:changelog, kooky:repoapi, kooky:issues, kooky:readme, kooky:persist

### OWN-07: Enterprise assurance

Verification status: No sourced public finding (not-published)
Support: not-published

No publishable sourced finding is available for this criterion. This does not mean the product lacks the capability.

### OWN-08: Useful free tier and evaluation access

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

Free to download and use, open source under MIT, with no trial, card or usage cap; agent subscriptions are separate.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Agent subscriptions and API usage are paid separately.

- ongoing_free — Ongoing free [supported]: Free download with no paid tier. Sources: kooky:readme, kooky:license.
- trial — Trial [unsupported]: No trial exists because nothing is paid. Sources: kooky:readme.
- credits_trial — Credits trial [unsupported]: No credits. Sources: kooky:readme.
- self_host_cost — Self host cost [supported]: Own Mac or SSH host; no fee. Sources: kooky:readme.
- paid_only — Paid only [unsupported]: Not paid-only. Sources: kooky:readme.
- early_access — Early access [unsupported]: No gated access. Sources: kooky:release.
- free_scenarios — Free scenarios [partial]: Single-user local and SSH use; collaboration, mobile and issues are absent. Sources: kooky:readme.
- card_required — Card required [supported]: No card or account. Sources: kooky:readme.
- usage_caps — Usage caps [unsupported]: No caps. Sources: kooky:readme.
- paid_evaluation — Paid evaluation [unsupported]: No payment needed. Sources: kooky:readme.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:license, kooky:release

### OWN-09: Pricing transparency

Verification status: Agent cross-checked (agent-cross-checked)
Support: partial

No pricing exists; the app is free and sponsorship is optional.

Availability: generally-available
Delivery: native
Scope: surfaces=Kooky native macOS app (SwiftUI, libghostty terminal); version=v0.51.12 (commit fc54bd9, released 2026-10-12); plan=Open source (MIT), free download; os=not specified; execution_modes=not specified; region=not specified; harness=not specified.

Limitations:
- Agent and compute costs sit outside.

- units — Units [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- included_limits — Included limits [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- overages — Overages [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- compute_markup — Compute markup [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- model_markup — Model markup [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- minimum_commitment — Minimum commitment [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- cancellation — Cancellation [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- sales_only_unknowns — Sales only unknowns [unsupported]: No prices, limits or overages to disclose. Sources: kooky:readme.
- transparency_classification — Transparency classification [supported]: Transparent: the app has no price and its license is public. Sources: kooky:readme, kooky:license.

Checked 2026-11-16 (6 days old on 2026-11-22); agent cross-checked 2026-11-17.

Sources: kooky:readme, kooky:license

## Sources

### kooky:readme

Kooky README. Native macOS 14+ terminal with sidebar workspaces, splits, fifteen one-click agents with activity dots, worktrees, SSH workspaces, keep-awake, notifications, history, kooky-cli; MIT; no accounts or telemetry; adhoc-signed DMG.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/README.md
- Locator: Features; CLI; Install; Build from source
- Evidence kind: documented
- Source date: Not stated
- Retrieved: 2026-11-16

### kooky:release

Kooky v0.51.12 release. Single asset Kooky-v0.51.12.dmg (10.1 MB), published 2026-10-12; no Windows, Linux, iOS or Android artifact.

- URL: https://github.com/iAmCorey/kooky/releases/tag/v0.51.12
- Locator: release assets
- Evidence kind: documented
- Source date: Not stated
- Retrieved: 2026-11-16

### kooky:pkg

Swift package manifest. macOS 14 floor; targets Kooky (app), KookyKit, KookyHook, kooky-cli and KookyHookKit; links GhosttyKit; no other platform.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Package.swift
- Locator: platforms and targets
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Package.swift

### kooky:agents

Built-in agent templates. Templates for terminal, claude-code, codex, gemini, opencode, amp, cursor, copilot, grok, antigravity, kimi, pi, omp, reasonix, kiro and droid; each launches the vendor CLI under a shell wrapper and resumes by exact conversation ID.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/AgentTemplate.swift#L420-L730
- Locator: built-in template definitions
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/AgentTemplate.swift

### kooky:cliproto

CLI wire protocol. Verbs: open, resume, list, focus, close, status, rename; versioned envelope.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyHookKit/CLIProtocol.swift#L63-L75
- Locator: KookyCLIVerb
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyHookKit/CLIProtocol.swift

### kooky:clictl

CLI request handling. Dispatches list, close, open, resume, focus, rename; refuses a protocol version newer than the app.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/CLIController.swift#L165-L200
- Locator: handle(...)
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/CLIController.swift

### kooky:notif

Notification manager. macOS notifications when a background agent waits or a command fails; settings toggle each kind.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/NotificationManager.swift#L18-L45
- Locator: UNUserNotificationCenter wrapper
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/NotificationManager.swift

### kooky:persist

State persistence. state.json keeps workspaces, panes, cwd, worktree and SSH host; scrollback and processes cannot survive PTY exit, so panes respawn.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/Persistence.swift#L1-L30
- Locator: PersistedState
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/Persistence.swift

### kooky:gitstatus

Git status and diff pill. Status bar shows branch and git diff --numstat counts; popover lists changed files with insertions and deletions, not diff hunks.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/GitStatusFetcher.swift#L28-L45
- Locator: GitDiffSnapshot; diff --numstat
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/GitStatusFetcher.swift

### kooky:srch-clients

Bounded search: other clients. No non-macOS client, web client, phone client or editor extension; matches are Swift window objects.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w over Sources and Package.swift for linux, windows, docker, electron, tauri, webview, WKWebView, iOS, android
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:customagents

Custom agents and environment. User-defined agents (name + command, optional built-in base) with per-agent .env-style environment variables for Claude-based entries; KOOKY_-prefixed keys are dropped.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/AgentTemplate.swift#L880-L945
- Locator: CustomAgentData; parseEnv
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/AgentTemplate.swift

### kooky:hookenv

Hook wiring for agents. Kooky passes a generated hooks file to claude with --settings and writes managed hook blocks for other agents so lifecycle events reach the app.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Terminal/ShellIntegration.swift#L520-L570
- Locator: Claude --settings; cursor and gemini hooks.json
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Terminal/ShellIntegration.swift

### kooky:hooksrv

Local unix socket server. App owns a unix socket (mode 0600) that the hook helper and kooky-cli connect to; no network listener.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/HookServer.swift#L99-L150
- Locator: socketPath; chmod 0o600
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/HookServer.swift

### kooky:agentmon

Agent panel. Right panel lists every agent across windows sorted attention (waiting), failed, running, idle.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/AgentMonitor.swift#L35-L60
- Locator: state ordering
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/AgentMonitor.swift

### kooky:codexusage

Codex usage gauge. Reads Codex rollout token_count events for 5-hour and weekly rate-limit percentages, plan type and context-window occupancy; display only.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/CodexUsageMonitor.swift#L1-L60
- Locator: CodexUsage
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/CodexUsageMonitor.swift

### kooky:srch-tele

Bounded search: telemetry. No analytics or crash-reporting client; README says no telemetry; only the manual GitHub update check.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -i for telemetry, analytics, sentry, posthog, mixpanel, crashreport over Sources, README
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:worktree

Git worktree manager. Creates worktrees on a new or existing branch, adopts existing ones, removes with optional branch delete.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/WorktreeManager.swift#L25-L60
- Locator: git worktree add/remove
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/WorktreeManager.swift

### kooky:ssh

SSH workspace wrapper. SSH workspaces use ssh with ControlMaster multiplexing; every tab runs a plain ssh session and agents are started on the remote through the wrapper.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Terminal/ShellIntegration.swift#L275-L295
- Locator: ControlMaster / ControlPath
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Terminal/ShellIntegration.swift

### kooky:sshsheet

New SSH workspace sheet. File menu sheet that records a remote host for a workspace.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sidebar/CreateSSHWorkspaceSheet.swift#L1-L30
- Locator: CreateSSHWorkspaceSheet
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sidebar/CreateSSHWorkspaceSheet.swift

### kooky:clicmd

kooky-cli entry point. kooky-cli parses verbs and prints one reason line on failure; exit code 0 means accepted.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyCLI/main.swift
- Locator: main
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyCLI/main.swift

### kooky:deeplink

kooky:// deep links. kooky://resume?agent=&id=[&cwd=] with strict character validation; links cannot carry prompts or commands.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/DeepLink.swift#L1-L30
- Locator: resume link grammar
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/DeepLink.swift

### kooky:srch-api

Bounded search: APIs, MCP, webhooks, SDK. No MCP server or client, webhook, HTTP API or SDK; only the local unix socket CLI.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for mcp, webhook, openapi, NWListener, GraphQL, sdk over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:engine

libghostty terminal engine. Terminal sessions render through the libghostty xcframework inside SwiftUI/AppKit views.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Terminal/LibghosttyEngine.swift
- Locator: LibghosttyEngine
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Terminal/LibghosttyEngine.swift

### kooky:srch-issues

Bounded search: native issues and tasks. No issue, task or ticket entity; workspaces are folders.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for ticket, backlog, kanban, epic, jira, linear over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:changelog

Kooky changelog. Frequent small releases; v0.51.0 introduced kooky-cli; v0.51.12 added keyboard shortcuts and hidden history rows; no dated roadmap.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/CHANGELOG.md
- Locator: v0.51.0 to v0.51.12
- Evidence kind: documented
- Source date: Not stated
- Retrieved: 2026-11-16

### kooky:history

Agent session history. Scans each agent own transcript directory (for example ~/.claude/projects and ~/.codex/sessions) to list and resume past conversations; read-only.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Sessions/AgentSessionHistory.swift#L60-L70
- Locator: Store list; collectClaude; Codex rollouts
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Sessions/AgentSessionHistory.swift

### kooky:srch-orch

Bounded search: delegation and orchestration. No coordinator or delegation tool; kooky-cli is a tab-control interface.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for subagent, orchestrator, orchestration over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:srch-sched

Bounded search: schedules and triggers. No scheduler or event trigger.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for cron, launchd, LaunchAgent, crontab over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:license

MIT License. MIT License, copyright 2026 kooky contributors.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/LICENSE
- Locator: header
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: LICENSE

### kooky:sleep

Keep-awake including closed lid. Fixed two-verb root helper around pmset -a disablesleep with a one-time admin authorization; keeps the Mac awake while agents work.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/ClosedLidSleep.swift#L1-L40
- Locator: pmset disablesleep helper
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/ClosedLidSleep.swift

### kooky:srch-container

Bounded search: container or VM isolation. No container, VM or OS sandbox isolation.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for docker, podman, lima, colima, qemu, virtualization, sandbox-exec, seatbelt over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:clip

Clipboard confirmation. Confirmation sheet before risky paste and OSC 52 clipboard access.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Terminal/ClipboardConfirmSheet.swift#L169-L200
- Locator: ClipboardConfirmSheet
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Terminal/ClipboardConfirmSheet.swift

### kooky:secure

Secure keyboard input. Holds macOS secure keyboard input during password entry.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/Terminal/SecureInput.swift#L1-L20
- Locator: EnableSecureEventInput
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/Terminal/SecureInput.swift

### kooky:crash

Local crash forensics. Writes stderr and exit notes to ~/Library/Logs/kooky/stderr.log; nothing is uploaded.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/CrashForensics.swift#L1-L30
- Locator: redirectStderrIfDiscarded
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/CrashForensics.swift

### kooky:fileinfo

Session Info panel. Inspector shows git branch/diff, venv, Node version, process tree with CPU and memory, listening ports and last command exit code.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/SessionInfoView.swift#L320-L345
- Locator: process tree, ports, last command
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/SessionInfoView.swift

### kooky:srch-cost

Bounded search: cost tracking. No dollar cost, spend, budget or pricing code; only Codex rate-limit percentages.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for usd, dollar, spend, budget, totalCost, pricing over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:srch-team

Bounded search: collaboration and enterprise. No accounts, roles, SSO, sharing or multi-user features.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep -w for sso, saml, rbac, invite, multiplayer, presence over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:srch-pr

Bounded search: pull requests and delivery. No PR, commit, merge or deploy action; git is used read-only plus worktree and branch switching.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources
- Locator: grep for gh pr, pull request, createPR, merge request, git commit, git push over Sources
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources

### kooky:notice

Third-party notices. Bundled fonts (OFL) and Shiki theme palettes (MIT) retain upstream licenses; libghostty is linked as a dependency.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/NOTICE.md
- Locator: Bundled in the source tree
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: NOTICE.md

### kooky:repoapi

GitHub repository metadata. 656 stars, MIT, last push 2026-10-12, created 2026-05-08, no homepage set, not archived.

- URL: https://api.github.com/repos/iAmCorey/kooky
- Locator: stargazers_count, license, pushed_at
- Evidence kind: documented
- Source date: Not stated
- Retrieved: 2026-11-16

### kooky:update

Update checker. Manual Help menu check calls api.github.com releases/latest; no startup poll; only network call found in the app.

- URL: https://github.com/iAmCorey/kooky/blob/fc54bd9002aa97fd6d67edb9d13c4b5143360fee/Sources/KookyKit/App/UpdateChecker.swift#L1-L45
- Locator: UpdateChecker.check
- Evidence kind: source-inspected
- Source date: Not stated
- Retrieved: 2026-11-16
- Commit: fc54bd9002aa97fd6d67edb9d13c4b5143360fee
- Path: Sources/KookyKit/App/UpdateChecker.swift

### kooky:issues

Kooky pull requests and discussions. Open pull requests propose Mosh transport, project grouping and SSH ports; no roadmap or announcement.

- URL: https://github.com/iAmCorey/kooky/pulls
- Locator: open pull requests #48, #85, #87
- Evidence kind: documented
- Source date: Not stated
- Retrieved: 2026-11-16
