# Twos for Raycast

URL: https://www.raycast.com/parker_klein/twos

> Capture and organize your lists, to-dos, notes, and reminders in Twos.

- Install: raycast://extensions/parker_klein/twos
- Author: [Parker Klein](https://www.raycast.com/parker_klein)
- Installs: 698
- Platforms: macOS, Windows
- Categories: Productivity
- Updated: 2026-10-19
- Source: https://github.com/raycast/extensions/tree/6e41546d4072ee1684be8a03feaf4dcd655d5378/extensions/twos/

## Commands

- **Add Thing**: Add a to-do, note, or hyperlink to a list.
- **Search Things**: Search and browse your things; complete or open them.
- **Create List**: Create a new list.

## README

### Twos for Raycast

A [Raycast](https://raycast.com) extension for the Twos public API
(`https://writethingsdown.com/api/v1`).

#### Commands

- **Add Thing** — add a to-do / note / hyperlink to a list (with a list dropdown).
- **Search Things** — search/browse your things; mark complete, open the list, copy, or open a hyperlink.
- **Create List** — create a new list.

#### Auth

Set the **API Key** preference to a `twos_…` key from
**Twos → Settings → Advanced → API Keys** (sent as `Authorization: Bearer …`).

#### Opening results

**Search Things** opens a result in the NewTwos desktop app when it's installed,
falling back to the browser when it isn't. Opening a thing lands on its list
scrolled to that row.

The **Open Results In** preference overrides this: `Automatic` (the default),
`NewTwos Desktop App`, or `Browser`. Whichever isn't primary stays available as
the second action (`⌘↵`).

Detection looks for the app's bundle id (`com.twosballer.mobile`) among
installed applications, and the deep link it fires is
`twos://list/<listId>?focus=<thingId>` — registered by the Electron main process
in `apps/desktop/electron/main.js`.

#### Develop

```bash
cd extensions/twos
npm install
npm run dev        # ray develop — loads the extension into Raycast
```

#### Publish (free)

1. Icon is already at `assets/extension-icon.png` (512×512, the current app icon).
2. `npm run build` then `npm run lint`.
3. `npm run publish` — opens a PR to the `raycast/extensions` store repo for review.

The Raycast Store is free to publish to.