Nobreiniers Chat: Breini on your phone
Install Nobreiniers Chat and pair your phone to talk with Breini and your Nobreiniers from anywhere.
Nobreiniers Chat puts Breini and your Nobreiniers on your phone: your companions, with their faces and characters, always with you. Every request is signed by the phone and by your Mac, and travels encrypted.
Before you start
- The Nobreiniers Chat app on your iPhone. Until it is out on the App Store, it installs with TestFlight: get it here (open the link on the iPhone; TestFlight asks you to install Apple's TestFlight app first).
- Tailscale is optional: without it, the phone reaches your Mac through our relay, encrypted end to end.
- Your Mac kept awake and NoBreiniers open with your profile, so Breini always answers.
Steps
- Open «Settings» (⌘,) › «Nobreiniers Chat».
- Press «Open Nobreiniers Chat», then «Turn on Nobreiniers Chat». You see «On · waiting for your private network» until your private network answers.
- Press «Pair a phone». A QR code appears.
- On the phone, open the app and scan the code with the camera. If you open the code with the phone's own camera or a link instead, write there the number your computer shows beside it.
- The phone shows up under «Paired phones» as «connected now».
Your first minute on the phone
- Open the app. On your Mac, open NoBreiniers › Connectors › Your phone: a code shows there. On the phone, tap the blue button and point the camera at it. If the code will not scan, tap «Type the Mac's name instead».
- No Mac at hand? Tap «See a demo»: the app shows itself with examples and no Mac, and Settings › «Connect with my Mac» brings you back.
- Write in a chat, or hold the microphone and talk. While a Nobreinier works, the button turns into «Stop»: tap it to cut the work.
- «Needs you» lists what waits for your yes or your answer. «Allow» or «Deny»; «Why not?» is optional.
- «Work» shows everything that runs now, each with its own «Stop».
- If your Mac is asleep or off, the app says so and sends what you wrote when it is back. Settings › «Disconnect this phone» ends the connection; you connect again with a new code.
Sign in with your account
The phone signs in with the same account as your Mac, as when you first opened NoBreiniers: you do not need the Mac in front of you. That is also how you reach a NoBreiniers running on a server with no screen.
- On the phone, open the app and tap «Sign in».
- Tap «Continue with Google» or «Continue with my e-mail». With the e-mail a message arrives: press its button and choose the number the phone shows, or type on the phone the six-digit code from the message.
- «Your computers» appears: your Macs and your servers with the chat on, each with its name and whether it is on now.
- Tap one. The phone asks for Face ID, your fingerprint or your passcode, and it is paired: its chat opens.
A computer already paired on this phone reads «Opened» and opens when you tap it. If it says your Mac is off or asleep, turn it on and tap it again.
- Only your account. The phone pairs this way only with your account's computers, and as yours. Someone in your business who signs in with their own e-mail does not see your computers: they pair with the code you give them in «Organization», as always.
- You always know. Every phone that signs in with your account leaves the notice «A phone signed in with your account and was linked: …» on your Mac, and it stays in the list of notices.
- If it was not you. In «Settings» (⌘,) › «Nobreiniers Chat» › «Paired phones», press «Revoke» on that phone. That phone no longer gets in with your account alone on any computer; if it was yours, scan the QR code to add it again. If the phone disconnects itself (Settings › «Disconnect this phone»), it can sign in with your account again whenever you like.
- Sign out. On the phone, Settings › «Sign out» forgets your account on that phone; computers already paired keep working.
- Your messages do not go through the account. Signing in only says who you are. What you write is signed by the phone and by your computer, encrypted end to end, and nobody else reads it.
Pair without a QR
A phone on your own Tailscale account asks by typing this Mac's name, with no screen in front of you. Press «Pair without a QR» and follow the steps. Being on your Tailscale account is not enough: it pairs only after your yes.
- On the phone, type the Mac's name. The phone says it is waiting for your yes.
- On the Mac a window opens by itself: «A device asks to pair». It names the phone it comes from; under «See details» you find its system and address. If it says it is a phone but is a computer, the window warns you: decline it unless you know it.
- Press «Allow» to pair it, or «Decline». The same request also appears in «Nobreiniers Chat» with «Allow» and «Decline», and as a card at the top of «Needs you» on a phone that is already paired, so you can answer from there.
The request waits 10 minutes; at most 4 wait at once. If nobody answers in time the phone says so: ask again, or scan the Mac's code. Once paired, the phone talks to Breini, answers what your agents ask you and can give a chat full access, which is why it asks first: any computer signed in to your Tailscale account could otherwise have paired.
The pairing code comes only from your Mac
A pairing code is a door into your Mac, so only your Mac's window shows one, with your click on «Pair a phone» or on «Use from a browser» (or a counterpart's code, which you make in «Organization»). An agent cannot make or read one either, not even if you ask it to: only your click in that window does. A phone that is already paired cannot make codes to pair other devices, and the phone app has no button for it: if a lost phone, or someone with access to it, asked for a code, the Mac refuses and says «A new device is paired only from the Mac, by its owner: open Settings › Nobreiniers Chat on the Mac and show the code there.»
Every time a new device is linked, by the QR code or with «Pair without a QR», the Mac leaves a security notice: «A new device was linked: …» with its name and how it came in, and «If it was not you, remove it in Settings › Nobreiniers Chat». It is not just a status line that the next message wipes: the notice stays in the list of notices, like something that waits for you, and it is not a status line that the next message wipes; and, like every security alarm, it reaches you even with «Focus» on. If it was not you, open «Settings» (⌘,) › «Nobreiniers Chat» and, under «Paired phones», press «Revoke» (the trash icon) on that phone and confirm with «Revoke?».
A message sent twice arrives once
If the Mac's answer is lost on the way (a weak connection, the Mac restarting to update) and the phone sends the same message or the same approval again, the Mac recognises it and does it once. You see one message in the chat, not two. It remembers it for three days, even if the app restarted in between, and forgets it if you unpair that phone.
Use NoBreiniers from a browser
You can also talk to Breini and your Nobreiniers from the browser of another computer, with nothing to install. Nobreiniers Chat has to be on and your Mac reachable through the relay.
- On your Mac, open «Settings» (⌘,) › «Nobreiniers Chat» and press «Use from a browser». If the button is off, its help says «Wait until this Mac is reachable through the relay.»
- A QR code appears. Scan the code with the phone's camera. To use it on this Mac, press the button that opens it in this Mac's browser («Link opened in this Mac's browser. It works once, for 10 minutes.»); on a Mac, iPhone or iPad near you, press the one that sends it there. The link is never copied, so no program on your Mac can read it. If you need another, the button now says «Another link».
- In the browser, choose «This computer is mine» (it stays connected for up to 30 days without use) or «It is a borrowed computer» (nothing is kept on that computer; it closes with the tab or after 1 hour without use) and press «Connect».
- The browser shows a six-digit number and waits. On your Mac, «A device asks to pair» opens, or the card appears on your phone: write that number there and press «Allow». Three wrong numbers refuse that browser. If your browser could not connect, press «Decline»: the one asking is not yours.
Only your Mac's window can allow a browser. A phone, even one already paired, neither sees that request nor answers it, and a link someone copied opens nothing without your «Allow».
What the browser does
- You see and write your chats, and «Stop» cuts a chat's work.
- You answer what your agents ask you: approvals and questions.
- You see «For you» and answer its proposals. A post is approved where you see it whole, on the Mac or in the app's window; on the phone you can cancel it.
- In «Overview» you see which chats wait for you, work, failed, are to read or are done, grouped, and open any of them.
- In «Projects» you see each project and all its chats, search any chat and start a «New chat» (text only: the browser does not send files yet).
- It does not yet send or receive files, receive calls, or alert you with the tab closed.
- If your Mac is asleep, off or without internet, the browser says so and tries again when it is back.
See them and remove them
Each browser shows up under «Paired phones» as «Browser», with the system it uses and until when its session lasts («until …»; a borrowed one says so). The session ends by itself on your Mac: on your own computer, after 30 days without use; on a borrowed one, after 1 hour. The browser then says it is no longer connected and to connect it again from your Mac, and the Mac notes that the session ended and removed it.
To remove a browser sooner, press «Revoke» (the trash icon) on its row and confirm with «Revoke?». From the browser itself, «Sign out of this browser» does the same.
Overview: what waits for you, what works, what failed
«Overview» shows at a glance what is going on in your Mac, with the chats grouped by where they stand, the newest first, and each one opens with a tap:
- «Waiting for you»: an approval or a question is waiting for your answer in that chat. The tab shows how many.
- «Working»: it is working right now.
- «Failed»: its last run failed, or its goal is stuck. It stays here until a later run ends well: write to it and it tries again.
- «To read»: it has an answer you have not seen on your Mac yet.
- «Done»: its goal is complete, or every item of its list is done or dropped.
- «Earlier»: everything else.
A group that holds more than it shows has «See all» with its count: it opens the whole list of that state, a page at a time. The overview updates by itself a moment after something changes while you look at it, and again when you open it or pull it down. If your Mac is not updated yet, the tab does not appear.
Your projects and all your chats
From the phone and from the browser you see everything on your Mac, not only today's:
- The «Projects» tab shows each project of the business, how many chats it has and when the latest moved. Tap one to see all its chats, the newest first; older ones load as you scroll down.
- «All chats» gathers every chat of the business: Breini's, your Nobreiniers' and the work that runs by itself.
- At the top, «Search all your chats» finds a chat by its name or by who works in it, with or without accents.
- Any chat opens with its whole history: you write in it, stop it with «Stop», or only read it if it is work that runs by itself.
Archived chats, the chats of another chat's inner helper, and the chats of a hidden or archived Nobreinier do not show.
Start a chat from the phone
- In «Chats» or inside a project, tap «New chat» (the pencil icon).
- In «Where», pick a project, «No project» or another folder on your Mac (it becomes a project of the business).
- In «Who works on it», pick Breini or one of your Nobreiniers.
- In «What it may do», leave «As your Mac sets it» or pick a level.
- Write your first message and tap «Start». On the phone you can also attach photos, files or a voice note; in the browser the first message is text.
The chat shows at once in your Mac's list, with the name your Mac gives it from what you asked, and opens on your phone so you follow the work live. If your Mac cannot start it, the phone tells you why and keeps what you wrote; it never sends it to another chat.
What reaches your phone
While the app is closed on your phone, your Mac lets it know what waits for you (an approval, a question, a hand-off, a call) and when a chat you wrote from the phone is answered or fails.
Each Nobreinier's notice setting holds here as on the Mac. In «Settings» › «Notifications & startup» › «Each Nobreinier’s notifications on this Mac»:
- «None»: only what waits for you reaches your phone (an approval, a question, a hand-off).
- «Only when it needs you»: only what waits for you reaches your phone.
- «Every notification»: that too, and its answers to the chats you wrote from the phone.
See Notifications and startup.
Your teammates, with their character
On the phone, Breini and every Nobreinier look the same as on the Mac. If you change a character under «Settings» › «Agents & helpers» › «Characters», the change shows on the phone too. See Change the character of Breini or a Nobreinier.
Lock the app
Nobreiniers Chat comes locked: every time it opens, and when the phone has been away from it for a while, it asks for Face ID, Touch ID or the iPhone's passcode (on Android, your fingerprint, face or screen lock). That way nobody holding your unlocked phone reads your chats. On the iPhone, while it is locked, its screen does not show in the app switcher.
- On the phone, open the app's settings. Under «Privacy» is «Lock Nobreiniers Chat».
- With the lock on, «Ask again» chooses when it asks again: «Immediately», «After 1 minute», «After 5 minutes» or «After 15 minutes».
- If you cancel the prompt, the app stays covered with an «Unlock» button to try again; nothing is deleted.
- A phone with no screen lock asks for a PIN of the app's own, 4 to 8 digits. If you forget it, set a screen lock on the phone and Nobreiniers Chat will use that instead.
The phone of a Nobreinier's counterpart
A person in your business who is the counterpart of a Nobreinier also uses Nobreiniers Chat, with a code of their own: you make it in Organization and they scan it. From then on they talk only with that Nobreinier and its groups, and with nothing else of your business. See A code for its counterpart to talk to its Nobreinier.
The code on your screen, kept safe
While a code to pair a phone or a browser is on your screen, no agent can take a picture of the screen, not even with «Full access». The app's window also stays out of your own screenshots for those minutes. Once the code is used, cancelled or expires, everything goes back to normal.
Tips
- If you use ACLs in Tailscale, allow your phones to reach this Mac, port 47800.
- If an agent needs your help in the browser, the phone tells you: «Needs your help in the browser.». What it needs shows once you open the app.
- A notice that asks for your approval is one line, who it is and what it needs («Mila needs your approval» and «Wants to send an e-mail to ana@example.com.»), with «Approve» and «View». It never shows a key or a whole text on the locked screen: «Approve» asks you to unlock the iPhone first and answers without opening the app, and «View» opens the approval with all its detail.
If something goes wrong
- «Your computers» is empty: on your Mac, open «Settings» (⌘,) › «Nobreiniers Chat» and check that it is on; the computer shows up within seconds. A computer only shows up with the same account you opened it with.
- «This computer belongs to another account»: you signed in with another e-mail. Sign out on the phone and sign in with your Mac's e-mail.
- «On · waiting for your private network» for a long time: open Tailscale on the Mac and check it is connected.
- «No phone yet…»: open Nobreiniers Chat and scan its code with the app.
