# Bigcursor

> Bigcursor is a TypeScript/JavaScript library that adds large cursors, natural mouse movement and typing, visible click feedback, and optional live click/key sounds to real Playwright browser input. Use it for product walkthroughs and recordings of coding agents testing features.

Website: https://www.bigcursor.dev. Source: https://github.com/seflless/bigcursor. Package name: bigcursor. Public API: import { createCursor } from "bigcursor", then await createCursor(page, { scale: 4 }) using an existing Playwright Page.

bigcursor 1.1.1 is prepared but not published. The public 1.1.0 archive contains an older API without the recording module. This guide requires 1.1.1; skill installation also requires the renamed skill on the default branch. Registry tarballs inspected November 11, 2026: 0.0.0-stage is a placeholder, and 1.1.0 lacks createCursor and bigcursor/recording. The prepared 1.1.1 package includes those APIs, natural typing, cursor dimming, the browser bundle, declarations, all 35 SVGs, and license notices. Until the matching runtime is published, report the missing release instead of cloning or building source. Maintainers can test the packed artifact locally.

Bigcursor delivers real Playwright input, with optional native capture through bigcursor/recording. It is not an autonomous agent, video editor, or replacement for assertions. Keep navigation, readiness checks, and assertions in Playwright. Await cursor actions sequentially and await cursor.dispose() in finally. A visual website demo or a video alone is not proof that a feature passed its checks.

Main actions: cursor.moveTo, cursor.click, cursor.drag, cursor.selectText, cursor.type, cursor.press, cursor.wait, cursor.configure, cursor.hideCursor, cursor.showCursor, and cursor.dispose. Targets generally accept Playwright locators, CSS selectors, or main-viewport CSS coordinates; selectText requires a locator or selector. Keyboard badges are opt-in and show modifier chords only, not all typed characters. Bigcursor does not guarantee capture FPS.

Install the Bigcursor skill: npx skills add seflless/bigcursor --skill bigcursor. Run in your project and choose your coding agent. Your agent handles the package and browser setup. The skill lives in skills/bigcursor in the source repository. Use the public package API, not bigcursor/internal (the website preview/workbench engine).

## Documentation

- [Complete agent guide](https://www.bigcursor.dev/docs.md): Skill installation, demo prompts, release status, manual setup, API, recording workflow, and limits. Read this before implementing.
- [Full-text alias](https://www.bigcursor.dev/llms-full.txt): The same complete guide in one plain-text response.
- [Human-readable docs](https://www.bigcursor.dev/docs): Skill installation, short demo prompts, and the Playwright reference.
- [Examples](https://www.bigcursor.dev/#examples): Visual previews and focused action snippets; these animations do not run real input against a product.

## Optional

- [Source and issues](https://github.com/seflless/bigcursor): Repository, package source, and bug reports.
- [npm package](https://www.npmjs.com/package/bigcursor): Check the available runtime release before installing.
- [Pointer Lab](https://www.bigcursor.dev/workbench): Tune appearance and export configuration.
- [Playwright video documentation](https://playwright.dev/docs/videos): Recording and video finalization.
- [Decode](https://decode.dev): Bigcursor is made by Decode.