Branch Press · docs
Your account and settings
Your profile and how to edit it, then Settings section by section: appearance, the AI agent, reading, security, and leaving.
Your profile
Account ▸ your name
Your profile is your public face on the site. Edit profile, under your name, changes:
- 1Photo. Change or remove it from the picture itself.
- 2Name and handle. The handle is your address:
/u?u=your-handle. - 3Bio. A web address in it becomes a link.
[label](https://…)gives the link words of its own: this one reads my notebook. - 4Public profile and private activity. Public is on by default; clear it and your profile answers nobody but you. The second lets your writing calendar count private writing too, as counts only, never content.
Share, beside it, copies your profile's link, posts it to X, LinkedIn or YouTube Community, or shows a QR code you can download for a card, a slide or a book.
The code is made in your browser and holds only your profile's address. It is always dark on light, whatever your theme, because some phone cameras cannot read the reverse. This one is real: it opens /u?u=your-handle.
Settings
Account ▸ Settings
Settings is grouped the way the island on its left lists them: Account, Profile, Appearance, Writing, Reading and Security.
- 1The island. Account, Profile, Appearance, Writing, Reading, Security. Below the line, back to your profile or to Branchspace.
- 2Theme. Four themes for the whole site. Hold the pointer on one for its name.
- 3Size. Everything at once, text, icons, logos and pictures, from its default of 100.
- 4First day of the week. Sunday or Monday, for your writing calendar.
Account
The address you signed in with, your profile's link to copy, and a place to change your password. At its foot, set apart: changing the email address you sign in with, which asks for your password and takes effect only once you confirm the link sent to the new address, and deleting your account.
Profile
The same profile can be edited here, in five cards: Photo, Name and handle, Bio and links, Visibility, and Profile graph. The profile page’s own Edit profile still works as before.
- 1Photo. Change, crop or remove it. This card saves separately.
- 2Name and handle. The address follows the handle. A change breaks the old address, so update links you have shared.
- 3Bio and links. Paste an address or write [label](https://…). The preview shows how the bio and links will read.
- 4Visibility. Choose a public profile and whether its calendar counts private activity. Save profile saves name, handle, bio and visibility together.
- 5Profile graph. Discipline colours save to your account and also colour Branchspace’s graphs and links. Default space, Tags and borrowed notes set the profile graph’s view in this browser only; the borrowed-notes control appears when available.
Links live inside the bio, as a pasted address or [label](https://…), with a live preview. Save profile saves name, handle, bio and visibility together; the photo and graph colours save separately.
The graph’s discipline colours are saved to your account. They apply to the profile graph and to Branchspace’s graphs and link colours too. Back to automatic lets the site choose again; the colour it picks stays put when another discipline appears. The graph’s view — Space, Tags and borrowed notes — is kept in this browser only.
Appearance
- Theme
- Four colour themes, applied across the whole site: Lqiia Scarce (dark), Soulish White (light), Haze Warmth and Harbor Dusk.
- Size
- Scales everything at once — text, icons, logos and pictures. Reset goes back to the default.
- First day of the week
- Sunday or Monday, for your writing calendar.
Branchspace style changes the workspace’s panels, menus and lettering. Choose Branch Default, Terminal Afterglow, Phosphor ’84 or Desktop ’95; the card shows the chosen style in the current theme, with Glow strength for the two glowing styles. The note keeps its own look. This choice is kept in this browser only; Styles in the Branchspace guide shows all four, their theme combinations and the glow controls.
Writing: the AI agent
Branchspace has an agent: an assistant in the Agent tab of its right pane that reads your notes and proposes changes — to the note you have open (links to related notes, tighter wording, tags, a new callout) or to another note it can reach; a new note, filled in, in the space you name; a new template, with its dates and times set to fill in by themselves; renaming a note, or moving it to another space or folder. With Ask before changes (the default), nothing changes until you accept the card, and an accepted change to the open note undoes with Ctrl Z like anything you type. Allow additions and Allow all edits let it make allowed changes at once, each with Undo, as below. It cannot delete notes, make spaces or folders, or publish.
It runs on your own OpenRouter account, which reaches Claude, GPT, Gemini and others. You connect it once, here or from the Agent tab, and OpenRouter bills you for what you use. Branch Press charges nothing for it and never sees your OpenRouter password or card.
- 1ConnectConnect OpenRouterIn Settings ▸ Writing, or in the Agent tab.
- 2On OpenRouteropenrouter.aiSign in there, add credit if you have none, and approve Branch Press. You come straight back.
- 3AskFind notes this should link toIn the Agent tab, about the note you have open.
- 4Accept or rejectAcceptWith Ask before changes, each proposal, one by one, or all at once.
A proposal shows what goes in (green), what comes out (struck through) and why. The same change is drawn over the note where it would land, with its own ✓ and ✕.
Three menus sit in the prompt box, under your question: what the agent may do without asking, how hard it works, and the model. Each choice in a menu says what it does. Auto, in the second, chooses a depth and model for each question: Think hard with the strong model for work across notes or a long question or note, Quick with a fast model for a small change, and Think otherwise. The answer says what it chose and why. You can also choose Quick (up to 15 steps), Think (the default, up to 30) or Think hard (up to 40). A step is one round of reading or proposing; deeper work costs more, and thinking is paid like writing.
AGENT.md holds your standing instructions: how to write, what to leave alone, how to link. Settings ▸ Writing ▸ AI agent ▸ Open AGENT.md opens or makes the one in Unfiled, for every space. Right-click a space ▸ Agent instructions for this space opens or makes that space’s own. Its instructions add to the Unfiled ones and win where they differ; your question wins over both. They never widen the agent’s powers. The tab says which it is following. These notes remain in the Explorer but stay out of graphs and the agent’s note lists.
The agent can map a space, read a note’s outgoing links and backlinks, and find mentions of a note that have not yet become links. A Link proposal turns a mention into [[Exact Title]], pointing to the note in the same space. With Ask before changes it waits for acceptance; with Allow additions or Allow all edits it can happen at once.
The first menu, with the shield, sets what it may do without asking. Ask before changes waits for every change. Allow additions makes new notes, templates, added paragraphs, added tags and new links at once; rewording, removing, renaming and moving still ask. Allow all edits makes every allowed change at once. Neither permits deleting notes, publishing or leaving its reading reach.
Each automatic change has a Done automatically card with Undo. An answer with several has Undo everything. Undo stops if you have changed that note since, so it cannot overwrite newer work. It lives in the open page only: reloading or reopening a saved conversation does not restore it.
You watch it work. Its thinking comes folded, with its newest line showing beneath; its answer appears as it is written; proposals arrive as it makes them, and you can accept one while it goes on. Stop ends the question and keeps what it had written.
- 1How hard it works. Auto, Quick, Think or Think hard. The same choice is in Settings.
- 2Its thinking, folded. Click to read it all. While it is thinking, the newest line shows beneath.
- 3What it has done. Every search, and every note it read.
- 4Where it is. The step, what it is doing, and for how long. If a model goes silent for two minutes, the question is stopped and says so.
Read Memory’s links
Found an unlinked mention of Habit
Ctrl Enter sends
- 1Following. The standing instructions in use. Click either AGENT.md to open it. The space’s instructions win where they differ.
- 2Done automatically. A permitted change has already happened. Undo restores it only if the note has not changed since.
- 3Undo everything. Appears when an answer made several changes automatically. Undo belongs to this open page; a saved conversation does not bring it back after a reload.
- 4Permission. What it may do without asking: Ask before changes waits for acceptance; Allow additions carries out added material; Allow all edits carries out every allowed change. Both keep Undo and respect the reading reach.
- 5Depth. Auto chooses for this question; Quick, Think and Think hard let you choose. The model is the menu beside it. Thinking, searches and step progress remain visible above the answer.
- 6The pinned foot. History, New conversation, what is left on your OpenRouter account, Add credit and Settings stay within reach. Enter makes a new line; Ctrl Enter sends (Cmd Enter on a Mac).
If a reply reaches its length limit instead, the card says that, and Continue lets it finish with twice the room. Asking something else is fine too: the conversation goes on from there.
Every conversation is saved to your account as you go, with the note it is about, so closing the page loses nothing. History, in the pinned controls at the foot of the tab, lists them all, newest first, on every device. Open one to carry on where you left it; the agent remembers the whole exchange. A conversation stays in the tab as you move from note to note, and each question tells the agent which note is open then. When you start a new one, the open note's earlier conversations are offered in the empty tab. New conversation starts afresh; the old one stays in History. Every question sends the whole conversation again, so a long one costs more each time.
- 1Back to the conversation you were in. History itself is in the pinned controls at the foot of the Agent tab.
- 2A conversation. Its first question, the note it is about, when you last asked, and what it has cost. The bar marks the one open now. Click to carry on.
- 3The bin. Appears as you point at a row. It asks once, then deletes that conversation from your account.
The AI agent card also keeps these choices on each device:
- Model
- Which model the agent uses. The list shows each one's price per million tokens, in and out. The Agent tab has the same list.
- Show a proposed change
- In the panel and in the note (the default), in the panel only, or in the note only.
- What the agent may read
- The open note's space, asking before it reads or changes anything in your other spaces (the default); or only that space, never asking. Templates belong to no space, so it may always propose one.
- How hard the agent works
- Auto, Quick, Think (the default) or Think hard, as above. With Auto, choose the strong model and a fast model for small changes. A model that cannot think still gets the extra steps and the longer replies, and the Agent tab says so.
- What the agent may do by itself
- Ask before changes (the default), Allow additions or Allow all edits. The Agent tab has the same choice in its prompt box, with Done cards and Undo.
Below the standing instructions, the card counts your saved conversations, with Delete all conversations, which asks once and cannot be undone.
What leaves Branch Press. What you ask, and the notes the agent reads to answer, go to OpenRouter and to the company running the model you chose (its maker, or a host OpenRouter routes to), and only to hosts that neither keep nor may train on what they are sent. Your conversations, with the note text they quote, are kept in your account, seen by no one else, until you delete them, and they go with it if you delete your account. Disconnecting forgets the connection here; the key stays on your OpenRouter account until you delete it at openrouter.ai/keys.
Reading
- Following
- Whether you hear about every public note or only essays from writers you follow, and whether your own journals reach your followers.
- People you have hidden
- Everyone whose comments you hid or whom you blocked, in one list, to undo.
- Saved categories
- Your shelves for saved essays: add, rename or delete one. Deleting a shelf removes only that shelf; the essays stay saved anywhere else you put them.
Security
- Sign out
- On this device.
- Active sessions
- Where you are signed in, from what the browser reports — not your exact location.
- Other sessions
- Terminate all other sessions signs you out everywhere except here. Use it if you signed in somewhere you no longer trust.
- Two-factor
- Adds a code from an authenticator app (Google Authenticator, Authy, 1Password) as a second step at sign-in. Keep the recovery codes it gives you somewhere safe.
Each line is a place you are signed in, named from what its browser reports. Sign out on a line ends that one; Terminate all other sessions ends every one but this.
- 1Add an appAdd an authenticator appIn Settings ▸ Security.
- 2ScanWith Google Authenticator, Authy or 1Password, or type the manual entry code instead.
- 3Verify000000Verify and enableType the six digits the app shows.
- 4Keep the codesH7K2-9MFQX3PD-Q8WZM4TN-2RBEC9VY-6JSATen of them, shown once. Put them in a password manager or on paper.
A recovery code is not a sign-in code. Each works once, if you lose the app: using one removes two-factor from your account so that you can sign in and set it up again. Regenerate recovery codes makes a fresh set, and the old ones stop working.
Your plan
/pricing
Every account starts free, with the whole of Branchspace. Some things carry an allowance on the free plan, such as one board and three album photographs. A paid plan lifts those allowances and shows a small badge beside your name. See /pricing for what each plan includes.
Telling us what is wrong
Your profile ▸ Private ▸ Report
If something breaks, says something untrue, or could simply be better, say so. There are three ways in: Report, under Private in the menu on the left of your profile; Report a problem or suggest an idea in Branchspace's Ctrl P commands; and the line at the foot of every guide.
Choose Something's wrong or An idea, write it in your own words, and send. The page you came from, your browser, your screen size and your theme go with it, so a problem can be found again. The form lists them before you send. Your email goes with it only if you tick You may reply to me by email. Only the founder reads reports.
Leaving
Take your writing first
Your writing is yours: any note can be taken out as Markdown or a Word file, or printed, from its menu in Branchspace. Do that first.
Delete account, at the foot of Settings ▸ Account, permanently deletes your account and everything in it: private notes, spaces, reading list, highlights, reading history, public profile and photo. You type DELETE to confirm, and it cannot be undone.
- 1Take it outMarkdown, Word or print, note by note, from Branchspace.
- 2Delete my accountDelete my accountAt the foot of Settings ▸ Account.
- 3Type DELETEDELETETyped, not clicked, so it cannot happen by accident.
- 4GoneNotes, spaces, reading list, highlights, history, profile and photo. There is no undo.
Where to go next
The other guides
- Using Branchspace — where the Agent tab lives.
- Publishing, and being read — what your public profile shows.
- Boards and the album — the two allowances, and what they are.