How bulletlist works
Everything the app does, on one page.
bulletlist is an outliner: one infinitely nested list, where every bullet can be zoomed into and treated as a page of its own. There is nothing to configure before it is useful — open it and start typing.
Getting started
Type your email address and we send you a code; type the code and you are in. There is no password to choose and none to forget, and if you have never been here before the account is created on the way through — signing in for the first time is signing up.
Everything is free, with no caps, no locked features and no trial that ends.
The basics
- ⏎ starts a new bullet, ⇥ indents it under the one above, ⇧⇥ pulls it back out.
- ⇧⏎ adds a comment under a bullet — the smaller second line, for the detail you do not want in the title. Comments can run to several lines (⏎ inside one starts a new line); at rest only the first line shows, with an ellipsis when there is more.
- ⌘⏎ completes a bullet. Completed bullets stay where they are; ⌘O hides and shows them. While they are hidden the caret moves to the next bullet on the same level as each one goes — the one above it once the level runs out — so ⌘⏎⌘⏎⌘⏎ ticks off a list without leaving it.
- Drag a bullet by its dot to move it, children and all. ⌘⇧↑ and ⌘⇧↓ do the same from the keyboard.
- Move to… in a bullet's ⋮ menu sends it somewhere that is not on the screen — the far side of the outline, three levels inside something else. Type the destination's name or fold the tree open until you see it — the same panel does both — and the bullet becomes the first thing inside it. The view follows: whatever was in the way — a folded branch, the completed filter, the page you were on — opens or moves, so you always land looking at where it went. It takes the whole selection when there is one, and one ⌘Z puts it all back.
- ⌘Z undoes, and it undoes the whole operation — an indent that moved four children comes back as one step.
Starting from a template
An empty outline is the hardest page in any outliner, so nine well-known ways of keeping notes ship with the app: Zettelkasten, PARA, Getting Things Done, the bullet journal, Cornell notes, the Feynman technique, the Eisenhower matrix, a weekly review, and the second-brain CODE steps.
Open the ⋯ menu and choose Start from a template…. Whichever you pick is added to the end of the page you are looking at, as one branch — nothing already there is touched, and ⌘Z takes the whole thing back if it was not what you wanted. Zoomed into a bullet when you ask, the template lands inside it.
They are ordinary bullets once they arrive. Rename them, delete the parts you do not use, and move what is left wherever it belongs.
Each method also has a short article at bulletlist.org/methods explaining what it actually is and how to run it — and each of those opens its template with no account at all, which is a good way to try one before you keep it.
Every bullet is a page
Click a bullet's dot, or press ⌘., and that bullet becomes the whole document: its text is the title and its children are the outline. ⌘, steps back out, ⌘' returns to the top, and the breadcrumb trail above the outline shows where you are and gets you back to any level in one click. Zooming is also the browser's back and forward buttons, so the trail you walked is real history.
⌘⇧8 stars the bullet you are in, which pins it to the sidebar — the list of the handful of places you keep returning to. On a phone, where there is no sidebar, the same list opens the outline browser.
Every page has an address
Because a bullet is a page, it has a URL: the one in the bar while you are zoomed into it, or Copy link in a bullet's ⋮ menu. Send it to someone, or keep it. It names the bullet itself rather than where it sits, so it still works after the bullet is renamed or moved.
Paste that address over a selected word or phrase in another bullet and the
phrase becomes a link to the first one — shown with a dotted underline, and a
click takes you there in place, with ‹ to come back. A link to a bullet that
has since been removed stays where it is and shows as struck through; restore
the bullet from the trash and the link works again. Links like this work
inside documents too, as [label](#/id), and an AI assistant
can write and follow them.
Documents
Any bullet can carry a full markdown document. ⌘⇧⏎ turns the bullet you are in into one and drops you straight into writing — or use "Turn into document" in the row's ⋮ menu. A document's dot becomes a small file icon, and opening it is the same move as ever: click the icon, and the bullet's page IS the document — title on top, the document below it, and the children still an ordinary outline underneath.
You write it the way it will look. A heading is a heading as you type it, bold is bold, a list is a list — the markdown is the file underneath, not the thing on screen. It is still markdown that gets stored, synced and copied, so nothing is locked in a format only this app can read.
Type it, or press it:
#+ space starts a heading,-a list,1.a numbered one,>a quote, three backticks a code block. ⌘B, ⌘I and ⌘E make the selection bold, italic or code.- The bar at the top of the document has the same moves — headings, bold, italic, code, link, lists, quote, code block — and stays with you as you scroll. Each button toggles: press it where it already applies and it comes off, and it lights up when the caret is somewhere that already wears it. On a phone those controls are on the strip above the keyboard, where the bullet actions live when you are in a bullet.
- Enter in a list starts the next item, and Tab indents it. Escape is always the way back to the outline, and the arrow keys walk out of the top and the bottom of the document.
Paste keeps its shape. Markdown pasted into a document is read as markdown —
a pasted # Title is a heading, a pasted table is a table — and so is a table
copied from Apple Notes, Google Docs or a web page. Tables are the one thing
the bar cannot make: they arrive by paste. Inside one, Tab moves to
the next cell and adds a row after the last, and Enter steps down a
row and out at the bottom. Pasting a page into an ordinary bullet turns that
bullet into a document, and opens it.
The button beside the copy button in the top right shows the document as a finished page — rendered, nothing editable — for reading it or handing it to someone. Press it again to go back to writing.
The bullet's text is the document's title — rename either, the other follows. Comments are separate from documents: a document can carry one under its bullet like any other row. A document you leave empty turns back into a plain bullet, so opening one to look costs nothing. The copy button above it puts the whole document on the clipboard as markdown.
Turning it back into an ordinary bullet. The bin at the end of the document's own bar deletes the document — and so does "Delete this document" in the row's ⋮ menu, which is what that row says once the bullet is already one. It asks first, because deleting the document deletes what is written on the page. The bullet itself survives: its title, its comment and everything underneath it are untouched, and it goes back to being a bullet like any other. ⌘Z brings the page back if you change your mind. A document nothing was written in skips the question — there is nothing on it to lose.
Document bodies sync like every other text: two devices editing the same paragraph merge by character, offline included, and export carries documents with the rest of the outline.
Working together
Any bullet can be opened to other people: the bullet, everything under it, and its own comment or document. Open its ⋮ menu and choose Collaborate.
Who can open it
The window has three choices, and the first is where every bullet starts:
- Only me — private. Nobody else can open it.
- Anyone with the link can view — they see it, and see it change as you type, but cannot change anything.
- Anyone with the link can edit — they change it with you, live.
Choosing does nothing yet. Pick view or edit and press Create link: only then is the bullet copied into its own shared space and the link made. Press Copy and send the link however you like. The bullet stays exactly where it was in your outline, now with a blue dot, and you keep working on it as before.
Nobody needs an account. A link opens as its own page in any browser. With an edit link they can type straight away; anyone who has an account can press Add to my outline to keep it there, live, next to their own bullets.
Treat a link like a key. Whoever has it can open the bullet, and there is no list of who did. Switching an edit link to view later changes which link the window offers, but an edit link already sent keeps working. To shut every link, choose Only me.
Ending it
Choose Only me and confirm. Every link stops receiving changes, and everyone, you included, keeps an ordinary private copy of exactly what the bullet held at that moment. Nothing is deleted from anyone's outline. Someone who added it to their outline sees it turn back into ordinary bullets, with a note saying the collaboration ended.
If you received a bullet and no longer want it, delete it from your outline like any bullet. That removes it for you only; the share and everyone else's copy are untouched, and it stays in your trash for 30 days.
Older devices
A phone or computer still running a version from before collaboration shows a shared bullet with nothing under it, and anything typed under it there goes to the trash instead of reaching the others. So when you create a link while one of your devices has not updated, the window names each one and when it was last used, and asks before going ahead: update it, forget it in Settings → Account → Devices if you no longer use it, or press Share anyway.
Share a copy
To send a bullet somewhere else rather than work on it together, choose Share a copy in its ⋮ menu. The bullet and everything under it go on the clipboard as real bullets for Google Docs, Notion, Slack or an email, with comments, bold and links kept and a document's page included, and as Markdown for plain-text places. On a phone it also opens the share sheet. ⌘C on selected bullets copies the same way. Nothing stays connected: it is a copy.
Copy link, beside it, copies the bullet's own address in your outline, which only you can open.
Finding things
- Esc opens search. It searches the whole outline — titles, comments, and document bodies — not just the part you are looking at, and completed bullets are included when they are shown. A match inside a comment or document shows a line of it under the result, and document hits wear the file icon.
- ⌘K is the palette: jump straight to any bullet by name, or run any command by its own name instead of remembering its key.
- The browser sheet is the outline as a tree you can fold: tap a bullet's chevron to see what is inside it, tap its name to go there. It is the same list the sidebar shows, for when there is no room for a sidebar — a phone, or a narrow window. Typing in it narrows the tree rather than replacing it, so a match is shown in the branch it lives in and you can carry on browsing from there.
Bringing an outline with you
Paste a nested list from Workflowy, Notion, Google Docs or any Markdown file and it arrives with its shape intact — indentation becomes nesting, not one flat bullet. Paste a page — a markdown file with headings and paragraphs, a table copied out of Apple Notes or a web page — and the bullet you paste into becomes a document holding it, named by its first heading, and opens. For a whole account, export it as OPML and drop the file anywhere on the outline: notes, completed state and links come across with the text.
Getting it out again
Export the outline as an OPML file at any time, without asking anyone. It is always the whole outline, completed bullets included, whatever the current view happens to hide — and it opens in Workflowy, Dynalist, Tana and Obsidian. This is the point: you are not locked in, and you can prove it in ten seconds.
Using it from an AI assistant
bulletlist is a connector: add it to an AI assistant once, and the assistant can search your outline, read any part of it, tell you what changed, add bullets, tick things off and tidy up — in any conversation, on whichever device you are talking to it from. It speaks the Model Context Protocol (MCP), the open standard assistants use to reach tools, so it is not tied to one vendor. Claude is the one it is tested with; the steps below are Claude's, and any assistant that takes a remote MCP server takes the same address.
In Claude, it is listed: open bulletlist in the Claude directory, click Connect, and sign in with your emailed code. Nothing to paste. The listing covers the Claude web app, the desktop app and the phone app at once.
Everything else is at bulletlist.org/connect: one button per assistant — Cursor and VS Code install in one click, ChatGPT, Claude Code and any other MCP client get the address and the steps.
By hand, as a custom connector: Customize → Connectors → Add → Add custom
connector, name it bulletlist, enter
https://bulletlist.org/api/mcp
and leave the rest as detected. Click Connect. You land on a bulletlist page that asks for your email and the same emailed code you sign in with; there is no password and nothing to copy out of the app. An address that has never used bulletlist gets its account on the way through, so you can start from the assistant and open the app later. Back in the assistant, the connector offers fourteen tools, and you can ask things like:
- What's on my list for this week?
- What did I write about the quarterly review?
- What changed in my outline last month?
- Add "call the accountant" under Work.
- Tick off the groceries.
- Turn the meeting notes into a document and tidy them up.
- Put this month's expenses in a sheet under Budget.
Setting up a whole structure, say a weekly planning template, is one call rather than one bullet at a time: the assistant hands over the nested list and it lands at once. The same goes for ticking off, moving or removing a batch of bullets: one call, one change to your outline, and either all of it lands or none of it does. Reading works the same way: the assistant sees the top of your outline with a count on every branch it did not open, and opens only the branches a question needs, so a large outline does not have to pass through the conversation to be useful.
Documents and sheets are the same ones you make in the app: a bullet with a page of markdown under it, or a small table. The assistant reads them in pages rather than all at once, and edits a long document by naming the passage to change rather than sending the whole page back, so a long document costs the conversation only the part being worked on.
When the assistant cross-references two parts of your outline it makes a real link between the bullets rather than spelling out a path, so what it writes is clickable and survives renames. Asked what points at a bullet, it can answer: reading one bullet lists every bullet that links to it.
The assistant is told to search before it writes and to work by bullet id, so a bullet it adds lands where you would put it and one it changes is the one you meant, and to ask before moving or removing anything you did not name. Removing is the same as in the app: the bullet goes to the trash, restorable for 30 days.
What the assistant sees, and what we keep. Only what a tool returns in that conversation — the bullets a search finds, the branch you asked it to read — goes to the assistant's provider, the way text you paste into a chat does. The bulletlist side is a small relay that keeps nothing: no copy of your outline, no password, no token at rest. Every request carries a sign-in token that the assistant holds, and the relay reads and writes your outline with your own account's permissions, the way one of your devices would. Disconnecting it in the assistant signs it out immediately. The privacy policy has the exact wording.
On your own machine instead. The same tools run locally, with no relay at
all: npm i -g @bulletlist/agent, then bulletlist login (or, for an
agent you reach through a chat app, bulletlist login --link: it sends you a
link to approve, and no code or password goes through the chat). That gives a
command line (bulletlist search, bulletlist recent --since 30d,
bulletlist add), a skill for Claude Code (bulletlist skill install), and
an MCP server for desktop assistants and coding agents
(bulletlist mcp --write). Reads are instant and work offline, because the
outline is a full copy on the machine, merged with your other devices through
the same sync the app uses.
Offline, and on your other devices
Every edit is written to your device first and to your account a moment later, so closing the tab or losing the network cannot lose work. With no connection the app keeps working on the local copy and catches up when there is one. If two devices edited the same outline while apart, the two versions are merged rather than one of them being thrown away.
Installing the app from your browser — "Add to home screen", or the install button in the address bar — gets you the same thing without a tab, and it works offline from the moment it is installed.
Making it yours
Everything you can set lives in one place: your initial in the corner, then Settings. On a phone that button sits at the right of the bar at the top.
Light or dark follows the system until you say otherwise, and the colour family underneath is yours to pick: ours, or Solarized, Gruvbox, Everforest, Stone, Dracula, Catppuccin, Nord or GitHub. Both halves ship for every one of them, so the light/dark switch keeps working inside whichever you choose. The choice is stored with your account, not with the browser, so the laptop and the phone agree.
The same sheet is where you say whether completed bullets show — the ✓ in the bar does it too, and so does ⌘O.
The two menus
There are only two, and the line between them is worth knowing:
- ⋯ is about this outline — collapse and expand everything, undo and redo, start from a template, import, export, print. On a phone it is the last button of the strip along the bottom; the ⋯ at the top of a phone is the menu of the bullet you are zoomed into.
- your initial is about you — settings, the keyboard shortcuts, these docs, sharing Bulletlist with someone, and signing out.
On a phone
The gestures stand in for the keys. Swipe a bullet sideways to indent or outdent it, press and hold to pick it up and drag it, and tap the ⋮ beside a bullet for everything else. While you are typing, a toolbar rides above the keyboard with the actions a laptop would reach by modifier key, and the line you are typing stays above the keys: a bullet that wraps, or a new one from Enter, is scrolled clear of the keyboard rather than hidden behind it. Not sure what a toolbar button does? Hold it: its name appears, and letting go does nothing.
To act on several bullets at once, press and hold one and let go without moving it. It is selected, and tapping other bullets adds them (or takes them back out). The toolbar then works on all of them: complete, star, indent or outdent, move them somewhere else, or delete them. Tap Done when you are finished.
When nothing is being edited the strip along the bottom is for getting around: browse the outline, go back, fold or unfold everything, search, and ⋯ for the rest of what you can do to the outline as a whole — sync now, show or hide completed, undo, import and export. The ⋯ at the top is different: it is the menu of the bullet you are zoomed into, the same one its ⋮ opens, and at the top of the outline there is none.
Your starred bullets are the first thing the browse button shows, each with the path to where it lives — tap one to go straight there.
To save something from another app — a web page, a post, a bit of text — use that app's Share button and pick Bulletlist. A small form opens with the title, the link and any text you had selected already filled in; change whatever you like, choose where it goes (your Inbox unless you pick one of your starred bullets), and save. It is added at the top of a bullet called Inbox at the top of your outline, which is made for you the first time. On an iPhone the form is part of the share sheet and the item is added the next time you open Bulletlist; on Android, Bulletlist itself opens with the form.
To pass Bulletlist on, your initial at the top has Share Bulletlist…, which opens the phone's share sheet with links to both app stores.
Move to… is on that toolbar too, and a phone is where it earns its keep: dragging a bullet to somewhere off the screen means holding it against the edge while the outline scrolls past. Tap it, then fold the tree open to the destination or type its name — the bullet goes in at the top, and the view follows it there.
Keyboard shortcuts
The same list the app shows under ⌘/. Where a binding differs by platform, both are given.
| Action | Mac | Windows / Linux |
|---|---|---|
| Add and edit | ||
| New item | ⏎ | Enter |
| Add a note | ⇧⏎ | Shift+Enter |
| Turn into document | ⌘⇧⏎ | Ctrl+Shift+Enter |
| Complete | ⌘⏎ | Ctrl+Enter |
| Delete | ⌘⇧⌫ | Ctrl+Shift+Backspace |
| Duplicate | ⌘⇧D | Alt+Shift+D |
| Link selected text | ⌘K | Ctrl+K |
| Bold selected text | ⌘B | Ctrl+B |
| Italicize selected text | ⌘I | Ctrl+I |
| Zoom | ||
| Zoom in | ⌘. | Alt+. |
| Zoom out | ⌘, | Alt+, |
| Navigate home | ⌘' | Ctrl+' |
| Star | ⌘⇧8 | Ctrl+Shift+8 |
| Jump to any item | ⌘K | Ctrl+K |
| Expand / collapse | ||
| Expand | ⌘↓ | Ctrl+↓ |
| Collapse | ⌘↑ | Ctrl+↑ |
| Change indent | ||
| Increase indent | ⇥ | Tab |
| Decrease indent | ⇧⇥ | Shift+Tab |
| Move | ||
| Move up | ⌘⇧↑ | Alt+Shift+↑ |
| Move down | ⌘⇧↓ | Alt+Shift+↓ |
| Select multiple items | ||
| Extend selection up | ⇧↑ | Shift+↑ |
| Extend selection down | ⇧↓ | Shift+↓ |
| Select siblings, then everything | ⌘A | Ctrl+A |
| Search | ||
| Search | ⎋ | Esc |
| Show / hide completed | ⌘O | Ctrl+O |
| System | ||
| Undo | ⌘Z | Ctrl+Z |
| Redo | ⌘⇧Z | Ctrl+Y |
| Show keyboard shortcuts | ⌘/ | Ctrl+Shift+/ |
Your data
Your outline is yours: no advertising, nothing sold, and nothing used to train anything. What you write is never sent anywhere but your own storage. A bullet you collaborate on is the one exception you make yourself: it is copied into its own shared space in the same storage, and anyone with its link can open it.
Google Analytics measures how the app is used — which pages and screens were opened, from roughly where, and counts of bullets added, completed, moved, deleted, zoomed and searched. Since 1.4.0 it is in the iOS and Android apps as well as on the website; before that it was the website only. It never sees a bullet, a note or a search query. The privacy policy is short and says exactly what is stored and where.
Taking it with you
Settings → Account → Export as OPML writes the whole outline to a file, at any time, without asking anyone. It is the same export as the one in the ⋯ menu, and OPML is what Workflowy, Dynalist and most other outliners read.
Deleting your account
Settings → Account → Delete account. You type one word to confirm, and then:
- every bullet in your outline is deleted from storage,
- your settings and this device's offline copy are deleted,
- your sign-in is closed.
There is no undo, no grace period, and nothing to email anyone about. If you want a copy, export it first — the button is directly above.
Not yet included: shared bullets. What is in a bullet you collaborated on, or what you typed into someone else's, stays in that shared space after you delete your account, and after the collaboration ends. Write to privacy@nozemans.com and it is deleted by hand.
The email address is not reserved afterwards. You can sign up with it again and you will get a new, empty outline.
Something missing?
Write to support@nozemans.com — a question that had to be asked is a page that needs a paragraph.
Questions people ask
Is bulletlist really free?
Yes. Every feature is free for everyone, with no caps, no locked tiers and no trial that ends. There is a donate button for anyone who thinks it earned its keep, and paying changes nothing about the app.
Do I need an account?
No. The demo at bulletlist.org/demo is the whole outliner, running in your browser, with nothing saved to a server. An account — an emailed code, no password — is what keeps the same outline on your other devices.
Can I bring my outline over from Workflowy, Notion or another outliner?
Yes. Paste a nested list from Workflowy, Notion, Google Docs or a Markdown file and the indentation arrives as nesting rather than as one flat bullet. For a whole account, export it as OPML and drop the file onto the outline: notes, completed state and links come across with it.
Can I get my outline out again?
Yes, as OPML or plain text, at any time and without asking anyone. The export is always the whole outline, completed bullets included, whatever the current view happens to hide — and it opens in Workflowy, Dynalist, Tana and Obsidian.
Does it work offline?
Yes. Every edit is written to your device first and to your account a moment later, so a closed tab or a lost connection cannot lose work. If two devices edited the same outline while apart, the two versions are merged rather than one of them being thrown away.
Is there an app for my phone?
There is a native app for iPhone and iPad on the App Store, and one for Android on Google Play. Either way the web app installs from the browser — "Add to home screen", or the install button in the address bar — and runs offline from the moment it is installed.
Can I use it from an AI assistant like Claude?
Yes. bulletlist is an MCP connector. In Claude, find it in the connector directory and click Connect; in any other assistant that takes one, add https://bulletlist.org/api/mcp as a custom connector. Sign in with your emailed code, and the assistant can search your outline, read it, tell you what changed, add bullets and tick them off.
Can I share a bullet or work on it with someone?
Yes. Choose Collaborate in a bullet's menu and create a link that lets anyone view it, or edit it with you live. Nobody needs an account to open it. Choosing Only me ends it, and everyone keeps a private copy. Share a copy instead sends the bullet to Docs, Notion, Slack or an email as real bullets.
Who can see what I write?
Nobody, unless you open a bullet to others with Collaborate: then anyone with its link can. Your outline is never sent anywhere but your own storage, and none of it is sold, used for advertising or used to train anything. The website and both apps measure how the app is used with Google Analytics — screens opened, and counts of bullets — which never sees a bullet itself, a note or a search query.
What happens if I delete my account?
Your outline goes: every bullet in it, your settings, this device's offline copy and your sign-in. There is no undo, so export a copy first. Bullets you collaborated on are not included yet: write to privacy@nozemans.com and they are deleted by hand. The email address can sign up again for a new, empty outline.