Don't let the cursor slow you down
Go to file
2024-05-15 11:55:04 +00:00
.github Make Forbid TODOs check into its own CI step (#2311) 2024-04-27 06:20:08 +00:00
.meta-updater Migrate to a pnpm monorepo (#1281) 2023-03-21 13:28:05 +00:00
.vscode C#: Migrate class scope (#2332) 2024-05-15 10:08:21 +00:00
changelog Community wrapper snippets (#1998) 2024-04-21 18:53:49 +00:00
cursorless-snippets Add Go support to snippets (#1591) 2023-07-07 08:09:44 +00:00
cursorless-talon Fix badge on cursorless-talon (#2313) 2024-04-29 08:30:50 +00:00
cursorless-talon-dev Fix or suppress all Python type errors (#2307) 2024-04-28 15:11:52 +00:00
data Add scope test machinery for remaining languages (#2326) 2024-05-15 11:55:04 +00:00
docs Add section for experimental custom regex scopes to customization.md (#2315) 2024-05-01 12:06:54 +00:00
fonts Update Cursorless icon in status bar (#2078) 2023-12-02 09:33:33 +00:00
images images/hats: close subpath in hole.svg (#2167) 2024-01-10 14:50:24 +00:00
packages Add scope test machinery for remaining languages (#2326) 2024-05-15 11:55:04 +00:00
patches bump docusauruas => 3.1.0 (#2176) 2024-01-18 06:32:17 +00:00
queries Add scope test machinery for remaining languages (#2326) 2024-05-15 11:55:04 +00:00
schemas Switch statement subject (#2046) 2023-11-23 11:29:04 +00:00
scripts Make Forbid TODOs check into its own CI step (#2311) 2024-04-27 06:20:08 +00:00
typings Move custom Object.keys() overload to util (#2020) 2023-11-11 16:21:41 +00:00
.editorconfig Fixtures data (#2276) 2024-04-05 15:38:18 +00:00
.eslintrc.json Disallow .only in mocha tests (#2107) 2023-12-07 13:41:28 +00:00
.git-blame-ignore-revs Update .git-blame-ignore-revs to exclude 4dc746c (#1198) 2022-12-22 10:02:23 +00:00
.gitignore move subset regular expressions to a separate file (#1690) 2023-08-14 13:52:43 +00:00
.npmrc Migrate to a pnpm monorepo (#1281) 2023-03-21 13:28:05 +00:00
.nvmrc Fix Windows CI by pinning node version (#2297) 2024-04-18 19:16:43 +00:00
.pre-commit-config.yaml Switch from black to ruff (#2306) 2024-04-26 15:37:23 +00:00
.prettierignore Fixtures data (#2276) 2024-04-05 15:38:18 +00:00
.prettierrc Add prettier-plugin-tailwindcss (#2245) 2024-03-25 19:50:54 +00:00
.syncpackrc.json Migrate to a pnpm monorepo (#1281) 2023-03-21 13:28:05 +00:00
CHANGELOG.md knausj => community (#1914) 2023-09-28 10:31:22 +00:00
CONTRIBUTING.md Serve docs folder and API reference on GitHub pages (#477) 2022-03-16 23:23:03 +00:00
LICENSE Add license 2021-05-04 12:07:25 +01:00
netlify.toml Migrate to a pnpm monorepo (#1281) 2023-03-21 13:28:05 +00:00
NOTICE.md Clean up badges; add ratings badge (#488) 2022-01-17 14:06:49 +00:00
package.json Bump pnpm => 9.0.6 (#2314) 2024-04-29 13:28:26 +00:00
pnpm-lock.yaml Bump pnpm => 9.0.6 (#2314) 2024-04-29 13:28:26 +00:00
pnpm-workspace.yaml Migrate to a pnpm monorepo (#1281) 2023-03-21 13:28:05 +00:00
pyproject.toml Fix or suppress all Python type errors (#2307) 2024-04-28 15:11:52 +00:00
README.md bump maintenance badge (#2230) 2024-02-08 13:16:49 +00:00
SECURITY.md Create SECURITY.md (#1184) 2022-12-15 18:44:28 +01:00
third-party-licenses.csv Create local extension sandbox (#691) 2022-05-25 19:46:15 +01:00
tsconfig.base.json bump typescript => 5.2.2 (#1979) 2023-11-13 13:30:21 +00:00
tsconfig.json Merge cursorless-vscode-core into cursorless-vscode (#1421) 2023-04-14 22:03:16 +00:00

Welcome to Cursorless!

Rating Documentation Tests Maintenance License: MIT

Cursorless is a spoken language for structural code editing, enabling developers to code by voice at speeds not possible with a keyboard. Cursorless decorates every token on the screen and defines a spoken language for rapid, high-level semantic manipulation of structured text.

Checkout the docs and videos to learn more. See installation for installation instructions.

And I heard you like GIFs?

Curly repack ox Move arg air and each to after drum Chuck tail red pipe slice past end of file

Installation

Currently depends on Talon, though a keyboard version is planned.

See installation for installation instructions.

Extension Settings

This extension contributes the following settings:

  • cursorless.showOnStart: Whether decorations should appear on workspace start
  • cursorless.hatSizeAdjustment: Percentage to increase or decrease hat size; positive increases size
  • cursorless.hatVerticalOffset: How much to vertically shift the hats as a percentage of font size; positive is up
  • cursorless.hatEnablement.colors: Whether to enable particular hat colors.
  • cursorless.hatEnablement.shapes: Whether to enable particular hat shapes.
  • cursorless.hatPenalties.colors: How much to penalize each hat color. You will probably want to set this one to the number of syllables in the given style. Cursorless will then sort every style combination by number of syllables to refer to it.
  • cursorless.hatPenalties.shapes: How much to penalize each hat shape. You will probably want to set this one to the number of syllables in the given style. Cursorless will then sort every style combination by number of syllables to refer to it.
  • cursorless.maximumHatStylePenalty: The maximum allowed penalty for a hat style. Any hat style whose penalty is greater than this amount will not be used. A hat style penalty is defined to be the shape penalty plus the colour penalty. Setting this value less than or equal to zero is treated as no maximum.

Known Issues

  • Cursorless calculates the position of the hats based on the characteristics of your font. If you find that the hats are off center you can try running this command: cursorless.recomputeDecorationStyles

Contributing

See contributing.

Change Log

See CHANGELOG.md.

Attributions

See NOTICE.md.