I’m thrilled that Atom—the newly-announced text editor from GitHub—is now out in the wild for more people to enjoy. It’s been my editor of choice for the past seven months. Atom is a delight to use. And for the first time, I’m using an editor that I find enjoyable to extend. There’s a ton to say about Atom, but for the moment, let’s talk about a quick way to start experimenting with extending the default Atom experience.
The majority of your Atom customizations will come in the form of packages. Packages provide an excellent means for defining commands and other customizations1. But sometimes I want to quickly define a new command without creating a full-blown package. Cue
Defining your first command
As a simple (and admittedly contrived) example, let’s define a command that logs a message to the console. For starters, add the following code to your
atom.commands.add 'atom-workspace', 'dot-atom:demo', -> console.log "Hello from dot-atom:demo"
init.coffee each time you open a new window. To test out this new command, you can open a new window, or you can reload the current window via the “Window: Reload” command in the Command Palette.
Now, use the Command Palette to locate and execute the new command by name (i.e., “Dot Atom: Demo”), as shown in the gif below. Each time you run the command, you’ll see the message logged to the console.
Defining and using a new command is just that simple.
If you’d like to trigger the command via a keyboard shortcut, you can define a keymap for the command in
init.coffee provides full access to Atom’s API, it’s fertile ground for implementing genuinely useful commands. For example, Lincoln Stoll uses his
init.coffee to define a command for generating ctags. In my
init.coffee, I define a command that closes all panes in one fell swoop, and I’m experimenting with a few other commands as well2.
Whether you need a sandbox for experimenting with new commands before publishing them in
a package, or you just want to define a few small commands without the overhead of an entire package,
init.coffee is the place to go.
Updated 7/10/2015: Atom 1.0 recently launched. To make it easier for readers to use this post in the era of Atom 1.0, I’ve updated the code in the
dot-atom:demo command to use the Atom 1.0 API, updated the documentation links to point to the current Atom documentation, and updated the links to
init.coffee files hosted on github.com to point to the latest versions of those files.