Download free

Programs on this Mac (local API)

Let other programs on your Mac talk to your Nobreiniers through the standard chat API many programs use. Off until you turn it on, this Mac only, one key per program.

Updated · version 2.0.256 · Markdown

Many programs (editors, writing tools, scripts) can talk to an AI through a standard chat API. NoBreiniers can answer them on your Mac, so those programs use your Nobreiniers: Breini, or any Nobreinier of your business.

Turn it on

  1. Open Settings › Programs on this Mac.
  2. Turn on Let programs on this Mac use your Nobreiniers.
  3. Copy the Address for the program. It looks like http://127.0.0.1:47615/v1.

It is off until you turn it on. While it is off, nothing on your Mac listens for programs.

A key for each program

  1. Under A key for each program, write the program's name (for example, "my editor") and press +.
  2. Copy the key right away. It is shown only this once.
  3. In the program's settings, paste the address as its "base URL" and the key as its "API key".

The list shows each key's name, when you made it, and when and by which program it was last used. To take a program's access away, press the bin next to its key and confirm. That key stops working at once, and everything the program has at work stops with it, also what waits in line.

NoBreiniers keeps only a fingerprint of each key, never the key itself. If you lose a key, revoke it and make a new one.

What a program can ask for

  • The model is the Nobreinier that answers: breini, or a Nobreinier's name. The program can read the list at GET /v1/models. With no model, Breini answers.
  • Chat: POST /v1/chat/completions, answered whole or word by word ("stream": true).
  • Responses: POST /v1/responses, with input, instructions and previous_response_id, also streamed.
  • Only text for now. A program that sends its own tools, pictures, or asks for several answers at once gets a clear error instead of a partial answer.

Agent apps (MCP)

Agent apps that speak MCP (the Model Context Protocol) can hand your Nobreiniers tasks. Settings › Programs on this Mac › Agent apps shows two ways, each ready to copy into the app's MCP servers:

  • With NoBreiniers' command line. The app runs osirisbrain mcp serve and works as you do at your command line: same folders, same permissions. It needs no key.
  • At its address, with a key. The app connects to http://127.0.0.1:47615/mcp (your port, if you changed it) with a key you make for it below. It works as a program: in chats of its own, and everything below holds for it. Put the key in the app's settings file, or in a NOBREINIERS_KEY variable the file names. Never type a key on a command line.

On Linux only the second way is shown: there NoBreiniers runs as a user of its own, so an agent app connects at the address, with a key.

Over the address, the app gets these tools:

  • ask: give Breini, or a Nobreinier by its name, a task or a question and wait for the answer. The app sees what it is doing while it works.
  • start_task, task_status, stop_task: start a long task, follow it (waiting in line, working on a step, waiting for your yes, done) and stop it.
  • list_agents: who can take a task.
  • list_conversations, read_conversation: the chats the app itself started. It never sees your other chats.

To go on with a task's conversation, the app passes its id, and the same Nobreinier answers in the same chat.

  • When a program stops its own task, or you revoke its key, the helpers and background commands that task started stop too; your own work in the same chat goes on.
  • A program can't take over your Mac: its tasks wait their turn when the Mac is busy, and start on their own.
  • A program can't take up all the Mac's room to be answered either: when one key already holds its share of what the Mac can serve at once, its next request gets a "too many requests" answer (status 429) that says in how many seconds to try again (Retry-After). A batch from an agent app gets that same answer for just the requests it could not take (error -32029, with retryAfter), and the rest are answered. Other programs, and you, are answered as usual.
  • Pausing all automatic work pauses what programs asked too: their running tasks stop, and new ones wait until you resume.
  • When you stop a chat, the program tasks waiting in it are cancelled too.
  • If you stop a chat with messages still in its queue, they wait for you; a program's task in that chat runs on its own and does not send them.
  • A task's answer stays readable for as long as its chat is there, also after NoBreiniers restarts.

What a program can never do

A program writes as itself, never as you:

  • Each conversation gets its own chat in your sidebar, named after the program. It never takes the chat you have on screen.
  • The chat works with the permission level new chats start with, and with your approvals: when its work needs your yes, the card waits for your click, and the program waits too.
  • A program cannot change your settings, answer your approvals or questions, see your keys or act "on your order". Its words are never read as commands: a message like /permission … is just text.
  • What it sends is treated as outside content, like a web page: what leaves your Mac goes through the same checks.

Only this Mac

  • The address works only from this Mac. Other computers on your network cannot reach it.
  • Web pages in a browser cannot use it, even on this Mac.
  • To change the port, press the pencil next to the address. If another program already uses that port, NoBreiniers tells you and keeps the old one.