explaingit

hvardhan878/ghostwork

Analysis updated 2026-05-18

122TypeScriptAudience · generalComplexity · 4/5LicenseSetup · moderate

TLDR

A Mac app that watches how you work in the background and gradually automates repetitive tasks it notices you doing, with local-only data and step-by-step approval before anything risky runs.

Mindmap

mindmap
  root((Ghostwork))
    What it does
      Watches activity
      Learns patterns
      Automates tasks
    Tech stack
      TypeScript
      Electron
      Screenpipe
    Use cases
      Automate repeated exports
      Undo automations
      Local only data
    Audience
      Mac power users
    Trust system
      Supervised mode
      Five accepts to auto run
      Approval for outside actions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let Ghostwork learn a repeated task, like exporting search results to your CRM, and automate it after you approve it a few times.

USE CASE 2

Review and undo any automation Ghostwork runs, since every new action starts in supervised mode.

USE CASE 3

Keep all activity data local, with personal information stripped before anything reaches an AI model.

What is it built with?

TypeScriptElectron

How does it compare?

hvardhan878/ghostworknick-baumann/gobbyclarilayer/clarilayer
Stars122122124
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/53/5
Audiencegeneraldeveloperdata

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires macOS 12+, Screenpipe running in the background, and an API key for an AI provider.

Modified versions must be shared under the same license, and the source code must remain open, including for network use.

In plain English

Ghostwork is a Mac application that watches everything you do on your computer and gradually takes over repetitive tasks without you telling it to. It runs in the background, silently recording your clicks, keystrokes, and app activity through a separate tool called Screenpipe. Over time it learns the patterns in how you work and starts automating the parts that repeat. The memory system has four layers that build on each other. The first layer holds what is currently on your screen. The second layer records raw events every two minutes: which apps you switched to, what you typed, where you clicked. Each night while you are not working, Ghostwork runs what the README calls a sleep cycle: it analyses the recent raw events, identifies patterns like "whenever I finish a LinkedIn search I export the results to my CRM", and compiles frequently repeated sequences into stored skills that can be replayed automatically. Automation happens on a trust system. New automations start in supervised mode, where Ghostwork runs the action and shows you a notification with an undo shortcut. After you have accepted the same automation at least five times without rejecting it, it switches to running silently. Actions that affect things outside your computer, like sending an email or submitting a form, always require a single tap of approval before they go through. When it executes actions, Ghostwork first tries the macOS accessibility layer to click and navigate natively. If that does not work it falls back to taking a screenshot and asking a vision-capable AI model to figure out where to click. If a multi-step action fails partway through, it automatically undoes the steps it already completed. All data stays on your machine. There is no cloud sync, no telemetry, and personally identifiable information like email addresses and card numbers is stripped before anything gets sent to an AI model. Raw events are deleted after 90 days. It is built with TypeScript and Electron. Setup requires macOS 12 or later, Screenpipe installed and running, Node.js 20 or newer, and an API key for an AI provider. The project is GPL-3.0 licensed.

Copy-paste prompts

Prompt 1
Install Ghostwork on my Mac along with Screenpipe and walk me through initial setup.
Prompt 2
Explain how Ghostwork's sleep cycle turns my repeated actions into an automated skill.
Prompt 3
Show me how Ghostwork's trust system decides when an automation can run without approval.
Prompt 4
Configure Ghostwork to always ask for approval before it sends an email or submits a form.

Frequently asked questions

What is ghostwork?

A Mac app that watches how you work in the background and gradually automates repetitive tasks it notices you doing, with local-only data and step-by-step approval before anything risky runs.

What language is ghostwork written in?

Mainly TypeScript. The stack also includes TypeScript, Electron.

What license does ghostwork use?

Modified versions must be shared under the same license, and the source code must remain open, including for network use.

How hard is ghostwork to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is ghostwork for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.