Orbari manual

Orbari is still being tested before release. These features are built, but they still need testing on real devices:

• recording, and turning speech into text
• sharing from other apps
• unlocking with Face ID or Touch ID
• adding items to Apple Reminders and Calendar
• saving files to iCloud Drive
• buying the unlock
• connecting to a Mac over your network.

1. Open Orbari. You start on the People list.
2. Choose Add Person.
3. Fill in the New Person form, then choose Save.
4. The new person appears in your list.

1. On iPhone, choose New Person in the bar at the bottom of the screen. As you scroll down, it shrinks to just its icon.
2. On iPad, choose New Person at the top of the screen.
3. On Mac, choose New Person in the toolbar, or press ⌘NCommand N.
4. Fill in the form and choose Save.

The free version keeps up to five people. When you have five, New Person offers Unlock Orbari, a one-time purchase, instead.

• Search finds people by name, notes, work, contact details and more. It also finds family and pets you keep under someone’s profile. Orbari calls this their orbit.
• Filters sit above the list: All, relationship groups such as Family or Work, your own groups and saved filters, Archived and Recently Deleted. Choose the plus button to save a new filter.
• Sort by First name, Last name, Age (oldest first) or Needs attention. Needs attention puts the people you haven’t caught up with in a while at the top.

On iPhone, the top of the People list shows Needs attention and Coming up. They hide while you search or filter.

On iPad and Mac, choose Home at the top of the sidebar. It shows Needs attention, Overdue follow-ups and Coming up.

• Add from Text or Recording: paste or record, and Orbari suggests people and details.
• Interviews: record or paste a longer talk, such as a relative telling family stories.
• Family & Pets: everyone you track in someone’s orbit.
• Tasks: errands and to-dos, for a person or just for you.
• Follow-ups: who to check in with, overdue first.
• Insights: who you catch up with most, and a custom field compared across people.
• Tree: a family or work tree around one person.
• Constellation: everyone, as a map of who knows whom.

On iPhone, most of these are at the top of the People list, and Tree is on each profile. On iPad and Mac, switch between List, Tree and Constellation above the main area. On Mac, Follow-ups and Insights start hidden. Control-click the toolbar to customise it and add them.

• Touch and hold a person, or Control-click them on Mac, for more choices: Set as you, Add to Group, Archive and Delete.
• Set as you marks the person who is you. Profiles can then show who you both know.
• Archive hides someone from your list. To bring them back, open the Archived filter and choose Restore to People.
• Delete moves someone to Recently Deleted. From there you can choose Restore, or Delete Permanently to remove them for good.
• To act on several people at once, choose Edit on iPhone or iPad and select them. On Mac, Command-click to select them. Then you can share, group, archive or delete them together.

1. To add a photo, choose Add Photo and pick one. You can skip this.
2. Type their Full name.
3. If buttons with family names appear under the name, choose one. This keeps a family’s surname spelled the same way.
4. Custom initials is optional. Use it if you want different letters in their profile circle. Leave it blank to use their initials.

Add a Job title and Company if it helps you remember them. Leave them blank for family and friends.

Notes is for the big picture: how you know them and what matters to them. The box says Anything you want to remember.

First fact is for one thing worth remembering, such as how you met. Orbari saves it as a fact on their profile.

To hide Work, Notes or First fact on this form, open Settings, choose People Data, then use the switches under New contact form.

Choose Save to add the person. You can’t save until you type a name. Choose Cancel to close the form. If you’ve typed anything, Orbari asks before it throws it away.

The free version keeps up to five people. Unlock Orbari to add more.

1. Open their profile.
2. Select their name or photo at the top. Or choose Add, then Edit Person.
3. Change the photo, Full name, Custom initials, Job title, Company or Notes.
4. Choose Save.

Touch and hold an item, or Control-click it on Mac. Then choose Edit, Remove or Delete. On iPhone and iPad, you can also swipe left on most items.

Selecting a contact row calls, emails or opens it. To copy it instead, touch and hold it (or Control-click it) and choose Copy.

Write down a conversation or time together. You choose when it happened and what kind it was, write what you talked about, and add follow-ups. For someone who has passed away, this button says Add a memory. Read the steps for logging a catch-up.

Adds a task to do with this person, such as returning something you borrowed. Read the steps for adding a task.

Add Contact Info saves a phone number, email, social account, website or address. Add Important Date saves a birthday, an anniversary or another day to remember. Read the steps for adding an important date.

1. Open a profile and choose Add, then Add Contact Info.
2. Choose the Type: Phone, Email, Social, Website or Address.
3. Choose a suggested label, such as Mobile or Work, or type your own.
4. Fill in Details. The box changes to suit the type you chose.
5. Choose Save.

Add Fact saves a short note about them. Add Detail / Custom Field saves a labelled value, such as a favourite colour. Add Name / Pronunciation saves a name in another language or script. Add Term of Address saves what someone calls them, such as Ayi or Uncle Ben.

1. Open a profile and choose Add, then Add Fact.
2. Write the fact.
3. Choose its Type: Date / timing, Place, Preference, Work or Note.
4. For a Place, Choose on Map lets you search for the place or drop a pin. Then choose Use This Place.
5. For Date / timing, you can write something like “came here about 10 years ago”. Choose Interpret date to see the date Orbari works out.
6. Choose Save.

Orbari may then ask on the profile if its date guess is right. Choose the tick to confirm it or the cross to reject it.

1. Open a profile and choose Add, then Add Detail / Custom Field.
2. Use Choose a saved field to pick one, such as Favourite food or Dietary needs. Or choose Custom field to make your own.
3. For your own field, type a Label and choose a Type: Text, Note, Date, Colour, Number, Yes / No or Link.
4. To use your field for anyone, turn on Make available for everyone. This needs the unlock.
5. Fill in the Value.
6. Choose Save.

1. Open a profile and choose Add, then Add Name / Pronunciation.
2. Type the name in any language or script.
3. Choose its Type and Language.
4. Under Pronunciation, add how it sounds. You can write it in the Latin alphabet, respell it, or use the International Phonetic Alphabet (IPA).
5. If your device can record, choose Record pronunciation to save a short clip.
6. Turn on Show under their name to show it under their main name on the profile.
7. Choose Save.

1. Open a profile and choose Add, then Add Term of Address.
2. Type the term, such as Ayi, Sensei or Uncle Ben.
3. Under Used by, say who calls them this. It starts as You.
4. Add how it sounds if that helps.
5. Choose Save.

Add Gift saves a gift idea, or a gift given or received. Add Debt or Loan saves money owed between you, either way.

1. Open a profile and choose Add, then Add Gift.
2. Name the gift, such as Climbing chalk bag.
3. Add notes, such as the size or where you saw it.
4. Add a Link and a Price if you like. The price uses your local currency symbol.
5. Choose the Status: Idea, Given or Received.
6. Choose Save.

1. Open a profile and choose Add, then Add Debt or Loan.
2. Under Who owes whom, choose I owe them or They owe me.
3. Enter the Amount.
4. Enter the Reason, such as Concert tickets.
5. Choose Save. When it’s paid, edit it and turn on Settled.

Add Relationship links this person to someone else in Orbari. Add to Their Orbit keeps track of a person or pet under this profile, without a full profile of their own. Read how to add relationships and people in their orbit.

Edit Person changes their name, photo, work and notes. Interview, followed by their name, starts an interview with them as the speaker.

1. On the People list, choose Add from Text or Recording. On Mac, you can also press ⌘ICommand I.
2. Paste a message thread, email, transcript or rough notes into Text.
3. Or choose Record a catch-up and talk. Then choose Stop & transcribe. Orbari turns your words into text in the box. It doesn’t keep this recording.
4. Choose Extract.

Recording and turning speech into text are built, but they’re still being tested on real devices.

1. In another app, such as Mail or Safari, choose Share.
2. Choose Add to Orbari. You can share text, a web link, or a file such as a saved email or a Portable Document Format (PDF) file.
3. Orbari shows Saved to Orbari. Open Orbari, and Add from text opens with what you shared.

Sharing from other apps is built, but it’s still being tested in release builds.

1. The Review screen lists each person Orbari found. Untick anyone you don’t want.
2. Under each name, a badge says New person or Links to, followed by a name. Select the badge to link them to someone already in Orbari, or to choose Make a new person.
3. Untick any facts, dates or gift ideas that are wrong.
4. If two names might be the same person, Orbari shows Possible duplicates. Choose Merge or Keep separate.
5. To keep someone in another person’s orbit instead of giving them a full profile, turn on the Track under switch.

1. Under Relationships, tick only the links that are right. Orbari saves a link only if it adds both people.
2. Under Catch-up, turn Log this catch-up on or off.
3. Use With to choose whose profile gets the catch-up.
4. Change Kind if you need to.
5. Choose Add to Orbari. To change the text first, choose Back.

If you reach the five-person free limit, Orbari adds who it can. It then tells you how many people need the unlock.

Apple Intelligence is Apple’s artificial intelligence (AI) on devices that support it. With it, Orbari understands your text better. Without it, Orbari uses a simpler reader, and the Review screen says Basic on-device extraction. Check the details carefully.

An interview is for a longer talk, such as a relative telling family stories.

1. Choose Interviews on the People list, then New interview. On Mac, you can press ⇧⌘IShift Command I.
2. Add a Title. Under Who’s speaking, choose Just my own notes, someone in Orbari, or Someone new.
3. Paste or type the conversation, or choose Record the conversation.
4. Choose Start to review what Orbari found. Or choose Save for later to finish another time.

Unfinished interviews wait in the Interviews list under In progress. Choose Resume to carry on.

1. Open a person’s profile.
2. Choose Log Catch-up. On iPhone, it’s the large button at the bottom. On Mac, you can press ⌘LCommand L.
3. Set When did you catch up?
4. Choose a Kind: Conversation, Call, Meal, Activity, Trip or Other.
5. Write notes under What did you talk about? Bullet points are fine.
6. Choose Save.

Choose Tidy notes to clean up what you wrote. With Apple Intelligence, Orbari tidies them on your device. Without it, Orbari turns your lines into a bullet list.

You see the tidy version first. Choose Use tidy version or Keep my notes. If you change your mind later, open Original notes and choose Restore original.

If your device can record, choose Record this catch-up. You can pause, resume and stop. The first time, Orbari asks to use the microphone.

Orbari keeps the recording on your device with the catch-up, so you can listen again later. It also tries to write what was said into your notes. To delete the recording, choose Remove recording.

Recording and turning speech into text are built, but they’re still being tested on real devices.

A follow-up is a reminder to check in with this person again.

1. Dates in your notes, such as “next Friday”, appear under Suggested follow-ups. Orbari may also suggest checking in after a number of days.
2. Choose a suggestion to add it.
3. Or choose Add follow-up to add your own.
4. Set the Title, the date next to On, and Add to: Reminder or Calendar event.
5. Save the catch-up.

If you’ve connected a Reminders list or calendar, Orbari adds the follow-up there when you save. If not, it stays in Orbari until you choose Schedule. Read more about follow-ups and reminders.

On the profile, touch and hold the catch-up, or Control-click it on Mac. Then choose Edit or Delete.

1. Open a person’s profile.
2. Choose Add, then Add Relationship.
3. Under Connect to, choose the other person. If nobody else is in Orbari yet, choose Add someone.
4. Under Relationship, choose the Type, such as Partner, Parent, Friend or Colleague.
5. For family types, choose the Kind: Full / Biological, Half, Step, Adoptive, Foster or Social.
6. Read the sentence under your choices. It says how the two are related. Then choose Save.

Orbari adds the matching link to the other person too. For example, if Sam is Alex’s parent, Alex shows as Sam’s child.

If something looks unusual, Orbari shows Just checking. Read it, then choose Save again to keep the link.

1. Open a person’s profile.
2. Choose Add, then Add to Their Orbit.
3. Type the person’s or pet’s name.
4. Choose the Type: Person or Pet.
5. Choose the Relation, such as Son, Partner or Friend. For a pet, choose Dog, Cat or Pet, and add Breed / details if you like.
6. Add notes, then choose Save.

Each person can have up to 10 people and pets in their orbit. To give one of them a full profile later, touch and hold them (or Control-click them on Mac) and choose Promote to Contact.

Use Add Relationship when both people need a full profile. Use Add to Their Orbit for children, partners, relatives, friends or pets you want to remember around someone. People and pets in someone’s orbit don’t count toward your five free people.

On a profile, Connected to lists their relationships. Choose Explore relatives to see people one or two steps away, such as cousins. Might be related shows links Orbari thinks may be true. Choose Add to keep one.

To see a family tree, choose Tree on a profile on iPhone. On iPad and Mac, switch to Tree.

1. Open a profile and choose Add, then Add Important Date.
2. Choose the Occasion: Birthday, Anniversary, Passed away, First met or Custom date. Birthday and Passed away appear only if the person doesn’t have one yet.
3. For Custom date, type a label, such as Graduation.
4. Set the Date. If you don’t know the year, turn on Year unknown, then choose just the month and day.
5. For First met, you can write the story under How you met.
6. Turn on Remind me every year to get a yearly reminder in Apple Reminders. Orbari asks for access the first time.
7. Choose Save. If Orbari shows Just checking, read it, then choose Save again to keep the date.

1. Open a profile and choose Add, then Add Task. Or choose New task in the Tasks list. On Mac, you can press ⌘TCommand T.
2. Type the task, such as Return her ladder.
3. Add details if you like.
4. Turn on Set a due date if it has a deadline.
5. Turn on Add to Reminders to put a copy in Apple Reminders.
6. If you didn’t start from a profile, choose who it’s For. You can choose No one — general task.
7. Choose Save.

The Tasks list sorts tasks into Overdue, Today, Upcoming, Someday and Completed.

Follow-ups are reminders to check in with someone. You add them when you log a catch-up. Tasks are for errands.

• A profile lists the follow-ups you haven’t finished under Needs attention. Choose Schedule to add one to Apple Reminders or Calendar. Choose Mark done once you’ve checked in.
• The Follow-ups list shows everyone’s follow-ups under Overdue, Today, Upcoming, No date and Recently resolved. You can also choose Dismiss.
• The first time you schedule one, Orbari asks which Reminders list or calendar to use. To change it later, open Settings, choose General, then go to Calendar & Reminders.
• Orbari never contacts anyone for you. It adds items to Reminders or Calendar only for the follow-ups, tasks and dates you set up.
• If you delete an item in Reminders or Calendar, Orbari shows Reconnect so you can add it back.

When Staleness cues is on, people in your list slowly turn amber, then red, the longer it’s been since your last catch-up. You can turn it off in Settings, under General.

For someone who has passed away, Orbari shows their lifespan instead and never nudges you to get in touch.

A gift can have a name, notes, a link, a price and a status: Idea, Given or Received. A debt records who owes whom, the amount and the reason. When you edit a debt, turn on Settled once it’s paid. Settled debts stay on the profile, crossed out.

Markdown files are plain text files that any text editor can open. Mirroring keeps a readable copy of each person in a folder.

1. Open Settings, then choose Sync.
2. If Markdown mirroring says Premium, choose Unlock Orbari first.
3. Turn on Markdown mirroring.
4. Check Status and Last sync to see that it ran.
5. Choose Export now whenever you want a fresh copy.

Obsidian is a notes app that reads folders of Markdown files. It calls each folder a vault.

1. Open Settings, then choose Sync.
2. Use the Choose Folder button to pick a folder you control, such as one inside your Obsidian vault.
3. To go back to Orbari’s own folder, choose Use Default Folder. That folder is in iCloud Drive when iCloud Drive is on. If it isn’t, Markdown folder shows On My Device.
4. Subcontacts are the people and pets in someone’s orbit. Turn on Subcontacts get their own files to give each one a file. Otherwise they’re included in that person’s file.

• Each person gets a file in a People folder. Saved recordings are copied into a Media folder.
• The files are copies, not a full backup. They can’t rebuild Orbari on another device.
• You can edit the text under the Notes heading in a person’s file. Orbari copies that text back into their notes.
• If you change anything else in a file, Orbari keeps your edited copy as a separate conflict file. Then it puts its own version back.
• Deleting a file never deletes the person.

1. Open a person’s profile and choose Share. To share everyone, open Settings, choose Data Management, then Share people. On Mac, you can also choose Share All People in the File menu.
2. Check the People and Connections counts. Sharing one person also includes everyone they’re connected to.
3. Under Include, choose what to send. Notes, Facts and Custom fields start off. Contact info, Important dates, photos and name recordings start on.
4. Choose Share. On Mac, you can also choose Save to disk.

Names, relationships, other names and people in their orbit are always included. Catch-ups are never shared. The file ends in .orbari. The person you send it to opens it in Orbari and chooses what to add.

To share several people, choose Edit in the People list on iPhone or iPad, select them, then choose Share. On Mac, select them, then choose Share in the toolbar.

To pick single items instead of whole groups, open Settings, choose Data Management, and set Sharing detail to Per field. This works when you share one person.

1. Open Settings, then choose Data Management.
2. For an .orbari file, choose Import from a file. On Mac, you can also choose Import People in the File menu. Opening the file in Orbari works too.
3. For contacts from another app, use a vCard or a comma-separated values (CSV) file. A vCard is a standard contact card file, and a CSV file is a simple spreadsheet. Choose Import from vCard or CSV.
4. Check the preview. Nothing changes until you confirm.
5. For an .orbari file, people you already have appear under Already in Orbari. Tick only the details you want to add.
6. Choose the Add or Import button to finish.

• Importing an .orbari file needs the unlock. Exporting your own people is always free.
• For now, vCard and CSV imports skip people who are already in Orbari.
• Imports count toward the five-person free limit.

Your Mac can send its people to your iPhone or iPad over your local area network (LAN), such as your home Wi-Fi. This is built, but it hasn’t yet been tested between real devices with a release build, so it may not work yet.

1. On the Mac, open Settings, choose Sync, then go to LAN sync server.
2. Set Reachable to Your network, then turn on Run sync server. The Mac shows a pairing code. It’s a Quick Response (QR) code, a square barcode.
3. On your iPhone or iPad, open Settings, choose Sync, then Connect to a Mac. Choose Scan pairing code and point the camera at the code on your Mac. If asked, let Orbari use the camera and find devices on your local network.
4. Choose Pull people from this Mac.

• Pulling people in needs the unlock on the iPhone or iPad. The Mac side is free.
• Each pull adds people you don’t have yet, and the connections between them. People already on your iPhone or iPad stay as they are.
• It’s a one-way copy each time, not a live sync.
• To unpair, choose Forget this Mac. To stop sharing, turn off Run sync server on the Mac.

Read more in Connect your own tools to Orbari.

Orbari doesn’t sync its records between your devices through iCloud yet. For now, you can share people as an .orbari file and import it on your other device. Or you can copy people from your Mac to your iPhone or iPad, as described above.

Markdown mirroring can’t do this. Its files are copies for reading, and they can’t rebuild Orbari on another device. Follow progress on the Orbari roadmap.

1. Open Settings, then choose Privacy.
2. Turn on Lock Orbari.
3. Choose a PIN of at least 4 digits, then enter it again.
4. Turn on Use Face ID or Use Touch ID if you like.
5. Under Auto-lock, choose when Orbari locks again: Immediately, After 1 minute, After 5 minutes or After 15 minutes.

Your PIN is stored only on this device and can’t be recovered, so keep it safe. Set up App Lock on each device separately. To lock Orbari straight away, choose Lock now. On Mac, it’s also in the File menu.

Open Settings, then choose General. Under On-device AI, Status says Ready, Not supported on this device, Turn on Apple Intelligence, Preparing local model, or Requires a newer OS (operating system). You can always add everything by hand.

Open Settings, then choose General.

• Appearance: System, Light or Dark.
• Background tint: a soft colour behind the app.
• Accent colour: System, Match tint or Custom.
• Profile icons: show 1 or 2 letters, taken from the Featured name or the Primary name only.
• App Icon: more icons come with the unlock.

Open Settings, then choose Plan, then Restore Purchases. Your unlock belongs to your Apple Account through the App Store.

Open Settings, then choose Data Management.

• Delete All Data removes every person and everything about them. Your settings stay.
• Reset App also erases your settings, your App Lock PIN and your sync connections. Orbari goes back to how it was the first time you opened it.

Both ask you to type DELETE or RESET to confirm, and neither can be undone. Files you exported or mirrored outside the app are kept.

The File menu also has Add Gift (with a person open), Share All People and Import People. In the Help menu, Orbari Help opens a short guide in the app, and Open Online Manual opens this page.

Orbari can show an icon in the Mac menu bar, at the top of the screen. Choose it to write a quick catch-up note: choose a person, set the date and time, write what you talked about, then choose Save Catch-up. Your draft stays there while Orbari is open, so save it before you quit.

To choose what the icon offers, or to hide it, open Settings, choose General, then go to Menu Bar.

Touch and hold the Orbari icon on your Home Screen. Then choose New Person, New Interview or New Task.

Check that Markdown mirroring is on and that the folder is still there. Then open Settings, choose Sync, and choose Export now. The files are copies. They don’t rebuild Orbari on another device.

Open Settings, choose General, and check On-device AI. If Status isn’t Ready, follow the message shown there. Without it, Orbari still reads text with a simpler reader, and you can add everything by hand.

Orbari needs to use the microphone. If you said no before, allow the microphone for Orbari in your device’s Settings, or in System Settings on Mac. Then try again.

Orbari needs access to Reminders or Calendar. If you said no before, allow it in your device’s Settings, or in System Settings on Mac. Then choose Try Again in Orbari. If you deleted an item in Reminders or Calendar, choose Reconnect in Orbari.

The free version keeps up to five people. Unlock Orbari for unlimited people. People and pets in someone’s orbit don’t count toward the five.

Open Settings, choose Plan, then choose Restore Purchases. Make sure you’re signed in with the Apple Account that bought the unlock.

It’s the same server that copies people to your iPhone or iPad. Here’s what to know:

• Mac only. Your Mac runs the server. iPhone and iPad can connect to it, but they don’t run one.
• Off until you turn it on. It never starts by itself.
• This Mac only, at first. With Reachable set to This Mac only, only apps on the same Mac can connect. They use plain Hypertext Transfer Protocol (HTTP), because nothing leaves your Mac.
• Your network, if you choose it. Other devices can then find your Mac through Bonjour, Apple’s way for devices to find each other on a local network. The connection is encrypted with Transport Layer Security (TLS), using a key made from your access token, so a device without the token can’t connect. This mode is for Orbari on your iPhone or iPad. Everyday tools such as curl, a command-line tool for web requests, can’t make this kind of connection.
• Mostly read-only. Tools can read your data. No tool can edit or delete anyone. Tools can add people only if you turn on Allow writes from the network.
• Private. Every request except the health check needs your access token. Nothing is sent to Orbari or any other company.

Reaching the server from another device is built, but it hasn’t yet been tested in a signed release build, the kind the App Store installs. It may not work yet.

An access token is a long secret code. Your tools send it with each request, like a password.

1. On your Mac, open Settings and choose Sync.
2. Under LAN sync server, leave Reachable set to This Mac only.
3. Turn on Run sync server. Address shows http://127.0.0.1:8787.
4. Choose Copy token. On screen, Orbari shows only its last four characters.
5. Paste the token into your tool, and keep it private.

To cut off everything that uses the old token, choose Regenerate token, then Regenerate. Then give your tools the new token. On a paired iPhone or iPad, choose Forget this Mac, then scan the new pairing code.

The server always uses port 8787, the number at the end of the address. If Status says the port is unavailable, another app is using it. Quit that app, then turn Run sync server off and on again.

Every address starts with http://127.0.0.1:8787. You can use localhost instead of 127.0.0.1. Every request except /health needs this header: Authorization: Bearer <your token>. GET requests read data. POST requests send data.

• GET /health: Shows whether the server is running. No token needed. It tells nothing about you.
• GET /api/people: Everyone, as a short list. For each person, it gives their id (a unique code), name, notes, number of facts and catch-ups, and when they last changed. The list also includes people you’ve archived or deleted, until you delete them permanently.
• GET /api/people/{id}.json: One person in full: work, notes, relationships, facts, important dates, contact info and catch-ups. Replace {id} with an id from the list.
• GET /api/people/{id}.md: One person as a Markdown note, like the mirrored files.
• GET /api/bundle: Everyone except archived and deleted people, as one .orbari share file. It includes notes, facts, photos and name recordings, but not catch-ups.
• POST /api/ingest: Send {"text": "…"}. Orbari reads the text and sends back the people and details it suggests. It saves nothing.
• POST /api/people: Send {"name": "…", "notes": "…"} to add a person. This works only when Allow writes from the network is on. New people count toward the five-person free limit.

Replies use JavaScript Object Notation (JSON), a common data format, except the .md address, which sends Markdown. Dates look like 2026-07-06T09:30:00Z. Values such as friend or birthday stay in English, whatever language the app uses.

curl comes with macOS. Open the Terminal app and run:

TOKEN=paste-your-token-here
BASE=http://127.0.0.1:8787

# Is the server running? (No token needed.)
curl "$BASE/health"

# Everyone
curl -H "Authorization: Bearer $TOKEN" "$BASE/api/people"

# One person in full. Use an id from the list.
PERSON_ID=paste-an-id-here
curl -H "Authorization: Bearer $TOKEN" "$BASE/api/people/$PERSON_ID.json"

• Error 401: the token is missing or wrong. Copy it again in Settings.
• Error 402: you tried to add a person, but you’ve reached the five-person free limit.
• Error 403: you tried to add a person, but Allow writes from the network is off.
• Error 404: there’s no person with that id, or the address is wrong.
• Error 421: use 127.0.0.1 or localhost in the address. Orbari turns away other names to block websites that try to reach your Mac.
• No answer at all: check that Run sync server is on and Reachable is set to This Mac only.

No tool can edit or delete people. While Allow writes from the network is off, as it is at first, tools can’t add people either. The server runs on your Mac, so nothing goes to Orbari or any other company. It’s made for your Mac and your local network, not for reaching your Mac over the internet.