Your desktop AI assistant that learns tasks from your screen recordings and runs them for you.

Teach once by recording your screen. Run it again with ClickCherry.

Privacy First

Everything stays on your Mac by default. No personal task/workspace data is sent to ClickCherry servers. The only network calls are direct LLM API calls from your local app to OpenAI or Gemini using your own provider API keys. No ClickCherry relay server is in the middle.

Get Started · Architecture · Release Process

Why ClickCherry

ClickCherry is built for people who repeatedly do desktop tasks and want a fast way to capture those workflows, structure them, and run them again.

• Native macOS app (SwiftUI)
• Local-first task workspace files
• Recording-first flow (New Task -> capture -> extract)
• LLM-backed extraction and execution
• Signed + notarized release pipeline

Privacy

ClickCherry is designed as a local-first desktop app:

• Task files, recordings, heartbeats, run logs, and local state stay on your machine.
• ClickCherry does not upload your personal workspace data to ClickCherry-operated servers.
• LLM requests are made directly from your local app to OpenAI or Gemini using your own API keys.
• No ClickCherry server proxies or relays those LLM requests.
• Your keys are stored in macOS Keychain.

Product Flow

flowchart LR
  A["Record desktop task (.mov)"] --> B["Extract task + heartbeat markdown"]
  B --> C["Review task details in app"]
  C --> D["Run task with desktop + terminal actions"]
  D --> E["Store run logs and summaries"]

Loading

Quickstart

1. Clone

git clone https://github.com/FarzamHejaziK/ClickCherry.git
cd ClickCherry

2. Build

xcodebuild -project TaskAgentMacOSApp/TaskAgentMacOSApp.xcodeproj \
  -scheme TaskAgentMacOSApp \
  -destination "platform=macOS" \
  -derivedDataPath /tmp/taskagent-dd-local \
  CODE_SIGNING_ALLOWED=NO build

3. Run Tests

xcodebuild -project TaskAgentMacOSApp/TaskAgentMacOSApp.xcodeproj \
  -scheme TaskAgentMacOSApp \
  -destination "platform=macOS,arch=arm64" \
  -derivedDataPath /tmp/taskagent-dd-local-tests \
  -parallel-testing-enabled NO \
  -only-testing:TaskAgentMacOSAppTests \
  CODE_SIGNING_ALLOWED=NO test

Documentation

Guide	Purpose
docs/getting-started.md	Install, build, test, and first contribution
docs/development.md	Repo structure, prompts, tests, PR expectations
docs/architecture.md	Core app modules and runtime data flow
docs/release-process.md	Tagging, release workflow, signing, notarization
docs/README.md	Documentation index

Open Source Baseline

• License: MIT (LICENSE)
• Contributions: CONTRIBUTING.md
• Contribution legal model: no DCO/CLA requirement
• Code of Conduct: CODE_OF_CONDUCT.md
• Security policy: SECURITY.md
• Governance: GOVERNANCE.md, MAINTAINERS.md
• Trademark/brand usage: TRADEMARK.md

Project Layout

• TaskAgentMacOSApp/ - app code, tests, Xcode project
• docs/ - public contributor and operator docs
• .github/ - CI/release workflows and repo automation
• .docs/ - internal maintainer planning and execution logs