# Xetera/ghost-cursor

🖱️ Generate human-like mouse movements with puppeteer or on any 2D plane

Repository: https://github.com/Xetera/ghost-cursor
Canonical: https://ross.abutalabs.com/products/ghost-cursor
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-11T17:37:21+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 2514, "days_push": 22, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1573, forks 165 (observed 2026-08-28T04:05:05.677201+00:00)

## What it is
A TypeScript library that generates human-like mouse movement paths using bezier curves, usable standalone on any 2D plane or integrated with Puppeteer for browser automation. It simulates realistic cursor behavior including overshoot, random point selection within elements, and speed adjustments.

## Use cases
- make puppeteer mouse movements look human
- avoid bot detection when automating clicks
- generate realistic cursor paths between two coordinates
- simulate human-like clicking in browser tests
- animate a cursor along a natural curve on a 2D plane

## When to choose
- you use Puppeteer and need undetectable, human-like mouse behavior
- you need programmatic realistic mouse path generation on any 2D plane
- you're building web scrapers or automation bots that must evade bot detection

## When to avoid
- you need real input-event simulation outside a browser context
- you want deterministic, exact-coordinate clicking for reliable test assertions
- your project doesn't use JavaScript/TypeScript or Node.js

## Facets
- artifact type: library
- maturity: active
- function: workflow-automation, simulation, testing
- domain: web-development, developer-tools
- platform: cross-platform
- tags: puppeteer, mouse-movement, bot-detection-evasion, bezier-curves, web-scraping, automation, nodejs

## Member repositories
- Xetera/ghost-cursor (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.677201+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:57:56.429751+00:00, confidence not recorded.
  - readme: https://github.com/Xetera/ghost-cursor (fetched 2026-08-28T04:05:05.677201+00:00, sha 1153ea2e12fc)
  - registry_npm: https://registry.npmjs.org/ghost-cursor (fetched 2026-08-29T11:27:56.008616+00:00, sha 7ea7ab1534f6)
- Data as of 2026-08-30T08:39:29.467469+00:00.