Skip to main content

1. Introduction

This tutorial will teach you the basics of Cursorless.

Step 1

Say "take cap"

Before
After

Step 2

Well done! 🙌 You just used the code word for 'c', "cap", to refer to the word with a gray hat over the 'c'.

When a hat is not gray, we say its color: say "take blue sun"

Before
After

Step 3

Selecting a single token is great, but often we need something bigger.

Say "take harp past drum" to select a range.

Before
After

Step 4

Despite its name, one of the most powerful aspects of Cursorless is the ability to use more than one cursor.

Let's try that: "take near and sun"

Before
After

Step 5

But let's show that Cursorless can live up to its name: we can say "chuck trap" to delete a word without ever moving our cursor.

Before
After

Step 6

Tokens are great, but they're just one way to think of a document.

Let's try working with lines: "chuck line odd"

Before
After

Step 7

We can also use "line" to refer to the line containing our cursor: "take line"

Before
After

Step 8

You now know how to select and delete; let's give you a couple more actions to play with: say "pre" to place the cursor before a target, as in "pre urge"

Before
After

Step 9

Say "post" to place the cursor after a target: "post air"

Before
After

Step 10

Say "change" to delete a word and move your cursor to where it used to be: "change sit"

Before
After

Step 11

And that wraps up unit 1 of the Cursorless tutorial! Next time, we'll write some code 🙌.

Next tutorial: 2. Basic coding

Continue to Basic coding - This tutorial will teach you the basics of coding with Cursorless.