Dabble app icon

Dabble

A beautiful, open-source to-do app.

Your devices sync with each other. No server required, no account. Plan your day on the Mac, check things off on your iPhone, and keep it all in step over your own network, or through your own encrypted sync server when you're apart.

Free and MIT licensed · macOS 15 or later · also as a .dmg · first launch tips

Dabble on the Mac showing the Today list
Today on the Mac
A project with headings and a progress pie on the Mac
Projects with headings
Dabble's home screen on iPhone
Your lists on iPhone
The Today list on iPhone
Today on iPhone
Features

Everything you love about a great to-do app.

Dabble follows the shape of Things: a calm place for today, a clear view of what's coming, and projects that show you how far you've come.

Plan your day

Today & This Evening

One list for what you'll do today, with a separate section for tonight. Due and scheduled items show up on their own.

Upcoming

See the days and weeks ahead at a glance, including the next instance of every repeating to-do.

Anytime & Someday

Everything you could do now lives in Anytime. Maybes and big ideas wait in Someday until you're ready.

Type a date, naturally

Write "tomorrow", "fri", "next week", "in 3 days" or "Dec 25" into When and Dabble understands.

Deadlines

Give a to-do a due date and get a countdown, "2 days left", so nothing sneaks up on you.

Reminders

Pick a time and get a notification on that device, scheduled locally. No push server involved.

Repeating to-dos

Repeat on a schedule (every Monday, the 1st of the month) or a set time after you complete it.

Organize

Inbox

Get it out of your head now and sort it later. Anything without a place lands here.

Projects & headings

Break big goals into steps, group them under headings, and watch the progress pie fill up.

Areas

Keep the parts of your life apart: Work, Home, Health. Areas hold projects and loose to-dos.

Checklists & notes

Every to-do has room for notes and a checklist of small steps you can tick off one by one.

Tags

Nested tags that projects and areas pass down to their to-dos. Filter any list by tag in a click.

Logbook & Trash

Completed to-dos move to the Logbook so you can look back. Deleted ones wait in the Trash.

Capture & find

Quick Entry

Press a global hotkey from any app on your Mac and jot a to-do down without switching windows.

Quick Find

Jump to any list, project, tag or to-do by typing a few letters.

Magic Plus

On iPhone and iPad, tap the plus to add a to-do, or drag it to drop one exactly where you want.

URL scheme

Automate with dabble:///add, add-project, show and search, the way things:/// works.

Feels right on every device

Keyboard shortcuts

On the Mac you can plan, schedule, tag and complete without touching the mouse.

Swipe actions

On iPhone, swipe a to-do to schedule it, move it, or delete it.

Drag & drop

Reorder to-dos, move them between lists, or drop them onto Today.

Multi-select

Select a handful of to-dos and schedule, tag, move or complete them all at once.

Undo

Completed the wrong thing? Deleted a project? Undo puts it back.

Backups you own

Export everything to a JSON file and import it anywhere. Your data is never locked in.

Light & dark

Follows your system appearance on Mac, iPhone and iPad.

How sync works

Your devices talk to each other. Nobody else is listening.

Most to-do apps keep your list on a company's server. Dabble keeps it on your devices and moves changes directly between them, encrypted, over your own network.

Mac, iPhone and iPad syncing directly A Mac, an iPad and an iPhone connected to each other by encrypted links over the local network. Above them, a dashed box labeled "Your sync server, optional" connects to the devices with dashed lines: an encrypted relay you can add for syncing when devices are apart. Your server optional · ciphertext only Same Wi‑Fi, or peer‑to‑peer Mac iPad iPhone
  1. Pair once by comparing a code

    Pick your other device, check that both show the same six digits, and tap Codes Match on each. Now they share a secret sync key. That key is the only "account" there is.

  2. Find each other nearby

    Devices discover each other on your Wi‑Fi, or over Apple's peer-to-peer Wi‑Fi when there's no router at all. Away from home? Add an address over a VPN like Tailscale, or run your own encrypted sync server.

  3. Talk privately

    Every connection starts with a fresh key exchange mixed with your sync key, then everything is encrypted. Devices without the key can't connect or read a thing.

  4. Send only what changed

    Devices ask each other for "everything since last time", so syncs are tiny. Changes hop along too: iPad → Mac → iPhone, even if the iPad and iPhone never meet.

  5. Merge without conflicts

    Each field of a to-do carries a timestamp. Rename it on your Mac and set a deadline on your iPhone, and you keep both. All devices settle on the same result.

  6. Optional: sync while apart

    Run the tiny open-source sync server on a machine you control. Devices push encrypted changes to it and pick up each other's within a second or two. It never sees what's on your list.

No server required No account Encrypted end to end Works without internet Open source

Good to know: devices sync while Dabble is open on both of them, or, with a sync server, whenever each one is open. iOS doesn't let apps keep a network connection in the background, so open Dabble on your iPhone and it catches up in a second or two.

Download

Get Dabble.

Free, open source and built from the code you can read on GitHub.

Mac

Requires macOS 15 Sequoia or later. Unzip, then drag Dabble into Applications.

First launch
  1. Dabble is signed ad hoc and not notarized by Apple, so the first time, right-click Dabble.app → Open and confirm.
  2. Or try to open it once, then go to System Settings → Privacy & Security and click Open Anyway.
  3. Or clear the quarantine flag in Terminal:
$ xattr -dr com.apple.quarantine /Applications/Dabble.app
Prefer to build it yourself?

Open Dabble.xcodeproj in Xcode 26 or later, pick the DabbleMac scheme and press Run. Every release also lists SHA-256 checksums in SHA256SUMS.txt. Details are in the README.

iPhone & iPad

Requires iOS or iPadOS 18 or later. Dabble isn't on the App Store, so pick one of two ways in:

Option 1 · Build with Xcode
  1. Install Xcode 26 or later and clone the repo:
    $ git clone https://github.com/nearbycoder/dabble.git $ open dabble/Dabble.xcodeproj
  2. Choose the DabbleiOS scheme, then under Signing & Capabilities pick your team. A free Apple ID works.
  3. Connect your iPhone or iPad, select it and press Run.
Option 2 · Sideload
  1. Download Dabble-iOS-unsigned.ipa from the latest release.
  2. Open it with AltStore or Sideloadly, which sign it with your Apple ID and install it.
  3. On the device, turn on Developer Mode if asked, and trust your profile in Settings → General → VPN & Device Management.

Apps signed with a free Apple ID stop opening after 7 days. Re-run from Xcode, or let AltStore refresh it. Your data stays put either way.

Optional sync server

Apart most of the time? Bring your own relay.

Nearby devices never need it. But if your iPhone and Mac are rarely on the same network, run Dabble's tiny open-source relay on any machine you control, and your devices sync through it from anywhere.

Sync relay

Optional · one file · Node 22.13+ or Docker

$ git clone https://github.com/nearbycoder/dabble.git $ cd dabble/server $ docker compose up -d

No Docker? node server.mjs works too. It listens on port 8787.

  1. Put it behind HTTPS: Caddy, a Cloudflare Tunnel, tailscale serve or Fly.io all work.
  2. On each device, open Settings → Sync → Sync Server, enter the address and choose Use Server.
  3. Adding a device that's never nearby? Copy the sync key from one that's set up, then use Join with Sync Key.
  4. Once everything's connected, set REGISTRATION=closed so nobody else can use your server.
View the server

End-to-end encrypted

Every key the server uses is derived from your sync key, and each field is sealed on your device with ChaCha20-Poly1305. The server stores ciphertext and timestamps, never your to-dos.

Fast

Changes go up about a second after you make them. Other devices long-poll, so they see them a second or two later.

Small

It keeps only the newest version of each field, so storage grows with your list, not your history. Zero dependencies: one Node file and SQLite.

Works alongside nearby sync

Devices on the same network still sync directly. The relay just fills the gaps when they're apart. Remove it any time; nothing else changes.

AI agents

Your AI agent can use Dabble too.

Claude, Cursor or your own scripts can do anything you can do in Dabble: plan your day, triage the Inbox, turn notes into a project, reschedule, tag and tidy up. It works through an MCP server, a command-line tool and an Agent Skill.

Set it up in a minute

macOS · works with any MCP app

  1. Install the tool. It ships inside Dabble for Mac. Settings → Agents shows a one-line command to link it, or run:
    $ curl -fsSL https://nearbycoder.github.io/dabble/install-cli.sh | sh
  2. Connect it. Settings → Agents also shows dabble join DBL1-… with your sync key filled in. Or run dabble pair and compare codes.
  3. Add it to your agent. For Claude Code, install the plugin. It bundles the MCP server and a skill that teaches Claude how Dabble works:
    $ claude plugin marketplace add nearbycoder/dabble $ claude plugin install dabble@dabble
    For Claude Desktop, Cursor and others, add the MCP server:
    { "mcpServers": { "dabble": { "command": "/usr/local/bin/dabble", "args": ["mcp"] } } }
Read the agent docs

Everything the app can do

24 tools: read any list, search, add to-dos, projects, areas, headings and tags, schedule, set deadlines, reminders and repeats, edit checklists, move, reorder, complete, trash and restore.

Still no server

The agent's dabble is a device in your sync group. It syncs with your Mac and iPhone like any other device, and its changes show up in the app within seconds.

Knows how Dabble works

The Agent Skill explains when vs deadline, Today vs Anytime, and good habits: look before changing, and ask before deleting anything for good.

Scriptable too

dabble today, dabble add "Call mom" --when tomorrow, dabble complete 8500f6b7. Add --json for scripts.

Try asking

“What's on my plate today?” · “Plan my week from my Anytime list.” · “Turn these meeting notes into to-dos in the Launch project.” · “Move everything tagged Errands to Saturday.”

Keyboard shortcuts

Fly through your list on the Mac.

The shortcuts follow the conventions you may already know from Things.

Create & find
New to-do⌘N
New to-do below selectionSpace
New project⌥⌘N
New heading⇧⌘N
Quick Entry, from any app⌃Space
Quick Find⌘F or just start typing
Undo / Redo⌘Z · ⇧⌘Z
Selected to-dos
Open / editReturn
Complete⌘K
When…⌘S
Start Today / This Evening⌘T · ⌘E
Anytime / Someday⌘R · ⌘O
Deadline⇧⌘D
Tags⇧⌘T
Move to…⇧⌘M
Move up / down⌥⌘↑ · ⌥⌘↓
Extend selection⇧↑ · ⇧↓
Move to Trash⌫
Go to
Inbox⌘1
Today⌘2
Upcoming⌘3
Anytime⌘4
Someday⌘5
Logbook⌘6
Settings⌘,
FAQ

Questions, answered.

Is there a server?

Not unless you want one. There is no Dabble-run server, no account and no sign-up. Your to-dos live in a file on each of your devices, and devices send changes straight to each other. If this website disappeared tomorrow, your copy of Dabble would keep working and syncing.

If your devices are rarely in the same place, you can run your own tiny sync server. It's one file, or one Docker container, and it only ever stores encrypted data.

What happens when I'm offline?

Everything keeps working. Add, edit and complete to-dos as usual. The next time two of your devices can see each other with Dabble open, they swap what changed and merge it.

Edits don't clash: each field (title, notes, when, deadline, tags…) is merged on its own, so changes to different fields are all kept. If the same field was edited on two devices, the most recent edit wins. Repeating to-dos completed on two offline devices still produce just one next instance.

Can I sync over the internet?

Yes, two ways. Run your own sync server: start the relay from the repo's server/ folder (node server.mjs or docker compose up) behind HTTPS, then enter its address under Settings → Sync → Sync Server on each device. It only stores end-to-end encrypted data, and changes arrive within a second or two.

Or use a VPN: install one such as Tailscale, then add the other device's address, for example my-mac.tailnet.ts.net:52384. Dabble listens on port 52384 by default. We don't recommend opening that port on your router to the whole internet.

To add a device that's never near your others, copy the sync key from one that's set up and paste it into Join with Sync Key.

Can AI agents use Dabble?

Yes. The dabble tool that ships inside the Mac app is an MCP server and a command-line tool, so Claude, Cursor or your own scripts can read and change anything you can in the app. There's also an Agent Skill that teaches agents how Dabble works. The agent joins your sync group as its own device, so there's still no server. Set it up from Settings → Agents.

Is my data encrypted?

On the wire, always. Every connection uses a fresh X25519 key exchange combined with your 256-bit sync key, and every message is sealed with ChaCha20-Poly1305. Devices that don't have your sync key can't connect, read or tamper with anything.

On disk, your data is a JSON file in Dabble's sandboxed app container, protected by your device's own encryption (FileVault on the Mac, Data Protection on iPhone and iPad). See SECURITY.md for the full threat model.

How do I add another device?

On a device that's already set up, open Settings → Sync and choose Pair New Device. On the new device, choose Join Another Device and pick the first one from the list. Both devices then show the same 6-digit code. Check that it matches and tap Codes Match on each. You can pair as many devices as you like, from any device already in the group.

Comparing the codes is what keeps pairing safe. There's no password to guess, and someone trying to sit in the middle would show you different codes. Details.

Does it import from Things?

Not yet. It's on the roadmap. You can move your data between Dabble installs with the JSON backup export and import, and the dabble:/// URL scheme makes it easy to script adding to-dos and projects.

Why isn't it on the App Store?

Dabble is a community project with no company behind it to pay for and run a developer account. You can build it yourself in a few minutes or sideload the release build. See iPhone & iPad.

What does it cost?

Nothing. Dabble is free and open source under the MIT License. Contributions are welcome on GitHub.

Get things done. Keep them yours.

Free for Mac, iPhone and iPad.