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:

1Change photoRemove
2Display nameYour Name Handleyour-handlelowercase letters, numbers, hyphens · 3–30 3BioWriting about habit and memory. More at [my notebook](https://example.org). 4Public profile — anyone can view this page Include private activity in my calendar (counts only, no content)
SaveCancel
  1. 1
    Photo. Change or remove it from the picture itself.
  2. 2
    Name and handle. The handle is your address: /u?u=your-handle.
  3. 3
    Bio. A web address in it becomes a link. [label](https://…) gives the link words of its own: this one reads my notebook.
  4. 4
    Public 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.
Edit profile, under your name on your profile.

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.

Edit profile Share

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.

Share, with the QR code open.

Settings

Account ▸ Settings

Settings is grouped the way the island on its left lists them: Account, Profile, Appearance, Writing, Reading and Security.

1 Account Profile Appearance Writing Reading Security
Your account Branchspace
2ThemeChoose a colour theme. It applies across Branch Press.
3Size
−100+Reset
4First day of the weekMonday
  1. 1
    The island. Account, Profile, Appearance, Writing, Reading, Security. Below the line, back to your profile or to Branchspace.
  2. 2
    Theme. Four themes for the whole site. Hold the pointer on one for its name.
  3. 3
    Size. Everything at once, text, icons, logos and pictures, from its default of 100.
  4. 4
    First day of the week. Sunday or Monday, for your writing calendar.
Settings, open at Appearance.

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.

1 Photo
YNChangeRemove
PNG, JPEG or WebP · crop before saving
2 Name and handle
Display nameYour NameHandleyour-notebookProfile address: /u?u=your-notebookChanging your handle means the old profile address will stop working.
3 Bio and links
Writing about habit. More at [my notebook](https://example.org).Preview
Writing about habit. More at my notebook.
4 Visibility
Public profile — anyone can view this pageInclude private activity in my calendar (counts only, no content)Save profile
5 Profile graph
psychologyChoose colourBack to automatic
Back to automatic for all
Default spaceAll spaces
Tags isolation
Choose allUnchoose all
psychologyhistoryShow borrowed notesColours: account · view: this browser
  1. 1
    Photo. Change, crop or remove it. This card saves separately.
  2. 2
    Name and handle. The address follows the handle. A change breaks the old address, so update links you have shared.
  3. 3
    Bio and links. Paste an address or write [label](https://…). The preview shows how the bio and links will read.
  4. 4
    Visibility. Choose a public profile and whether its calendar counts private activity. Save profile saves name, handle, bio and visibility together.
  5. 5
    Profile 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.
Settings ▸ Profile. Five cards; the profile page’s own Edit profile still works.

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.
Habit
A raised panel and a link
Lqiia Scarce, dark, the default.
Habit
A raised panel and a link
Soulish White, light.
Habit
A raised panel and a link
Haze Warmth, warm paper, terracotta.
Habit
A raised panel and a link
Harbor Dusk, night blue.
The four themes, in their own colours. Every page of the site, these guides included, follows the one you choose.

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.

  1. 1Connect
    Connect OpenRouter
    In Settings ▸ Writing, or in the Agent tab.
  2. 2On OpenRouter
    openrouter.ai
    Sign in there, add credit if you have none, and approve Branch Press. You come straight back.
  3. 3Ask
    Find notes this should link to
    In the Agent tab, about the note you have open.
  4. 4Accept or reject
    Accept
    With Ask before changes, each proposal, one by one, or all at once.
Connect once, then ask. Above the question box the Agent tab shows your OpenRouter balance, or what the agent has spent this month when OpenRouter does not share the balance, with Add credit beside it. With no note open, the agent still answers about your notes in general; to change a note, open it.
WorkspaceAgent
Find notes it should link to. Read “Synaptic Pruning”
ADD TO THE NOTE [[Synaptic Pruning]] Both describe the brain keeping what is used.
AcceptReject

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 ✕.

A proposal, in the Agent tab.

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.

WorkspaceAgent
Which notes should link to this one? Thought for 6 s2 Searched this space for “pruning”: 4 foundRead “Synaptic Pruning”Read “Habit Loops”3 Thinking · 3 s …both keep what is used, and lose the rest
Step 4 of 30 · Thinking · 0:21Stop4
Model · your choice
AutoQuickThinkThink hard1
  1. 1
    How hard it works. Auto, Quick, Think or Think hard. The same choice is in Settings.
  2. 2
    Its thinking, folded. Click to read it all. While it is thinking, the newest line shows beneath.
  3. 3
    What it has done. Every search, and every note it read.
  4. 4
    Where 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.
Working on a question. The answer appears as it is written, under the thinking that led to it.
WorkspaceAgent
1Following AGENT.md (all spaces) · AGENT.md (My Space)
Link the mention of Habit in Memory. ▸ Thought for 6 sMapped My Space · 4 notes
Read Memory’s links
Found an unlinked mention of Habit
2
LINK · MemoryHabit → [[Habit]]The mention names this note.
Done automatically.Undo
3
2 changes made automaticallyUndo everything
Check references yourself. AI can find sources fast, but it cannot check them as well as a specialist can. Ask about this note, or ask for a change…
Ctrl Enter sends
4Allow additions ▾
5Think ▾
Sonnet 5.5 ▾Send
6
◷ History+ New conversation$9.00 leftAdd creditSettings
  1. 1
    Following. The standing instructions in use. Click either AGENT.md to open it. The space’s instructions win where they differ.
  2. 2
    Done automatically. A permitted change has already happened. Undo restores it only if the note has not changed since.
  3. 3
    Undo 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.
  4. 4
    Permission. 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.
  5. 5
    Depth. 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.
  6. 6
    The 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).
The Agent tab. A Link card and the controls below it; a second automatic change is counted by Undo everything.
Read “Habit Loops”Read “The Keystone Habit”Read “Cue, Routine, Reward”
It used the 30 steps it may take on one question. Continue gives it 30 more.Continue

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.

When the steps run out. Everything it did so far stays, proposals included.

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.

WorkspaceAgent
Back1 Conversations Saved in your account, on every device.
Which notes should link to this one?About “Habit Loops” · 2 hours ago · $0.042
Make me a daily templateNo note · 29 Sep · $0.023
Tighten the fleeting noteAbout “A thought to keep” · 27 Sep · $0.01
  1. 1
    Back to the conversation you were in. History itself is in the pinned controls at the foot of the Agent tab.
  2. 2
    A 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.
  3. 3
    The bin. Appears as you point at a row. It asks once, then deletes that conversation from your account.
History, in the Agent tab. Deleting a note keeps its conversations; they say “deleted” beside its title.

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.
Active sessions
Chrome on WindowsActive just now · This device
Safari on iPhoneActive 2 days ago Sign out
Firefox on LinuxActive 3 weeks ago Sign out
Terminate all other sessions

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.

Active sessions, in Settings ▸ Security.
  1. 1Add an app
    Add an authenticator app
    In Settings ▸ Security.
  2. 2Scan
    With Google Authenticator, Authy or 1Password, or type the manual entry code instead.
  3. 3Verify
    000000Verify and enable
    Type the six digits the app shows.
  4. 4Keep the codes
    H7K2-9MFQX3PD-Q8WZM4TN-2RBEC9VY-6JSA
    Ten of them, shown once. Put them in a password manager or on paper.
Turning on two-factor. From then on, signing in asks for your password and then a code from the app.

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.

  1. 1Take it out
    Markdown, Word or print, note by note, from Branchspace.
  2. 2Delete my account
    Delete my account
    At the foot of Settings ▸ Account.
  3. 3Type DELETE
    DELETE
    Typed, not clicked, so it cannot happen by accident.
  4. 4Gone
    Notes, spaces, reading list, highlights, history, profile and photo. There is no undo.
Leaving, in the order that loses nothing you meant to keep.

Where to go next

The other guides

All guides

Something wrong or unclear here? Tell us

Last checked against the site on 6 October 2026