codus
← All documentation

Can a Brain on one computer message a Brain on my other computer?

Yes. In Codus 0.2.226 or later, a Brain can message a Brain on your other computer when both computers are signed in to the same Codus account. Ask in plain words, for example "tell the Main Brain on my laptop that the release is out". The message lands in that Brain's inbox, marked as coming from a Brain on another computer, and the other Brain can reply the same way.

Before you start

  • Update Codus to 0.2.226 or later on both computers through Settings → Updates, then fully quit and reopen it.
  • Sign in to the same Codus GitHub account on both computers.
  • Each Brain needs to have synced with the Codus cloud once. This happens on its own within a minute of opening Codus.

Send a message to a Brain on your other computer

  1. In a Brain's chat, ask it who it can reach, for example "which Brains can you message?". It lists the Brains on this computer, then the ones on your other computers as Name @ Computer, with when that computer was last online.
  2. Tell it what to send and to which Brain, for example "send the Main Brain @ Office PC a note that I've merged the branch".
  3. The Brain confirms the message is queued. If the other computer is asleep or Codus is closed there, the message waits for up to 7 days and arrives when Codus opens.

If two Brains share the same name and computer name, the Brain asks you which one by its id. A Brain cannot message itself.

What the other Brain sees

The message arrives in the other Brain's inbox, starting with which Brain sent it and from which computer. It is clearly marked as a message from another Brain, not your instruction or approval, so a Brain on one computer can never approve something on your behalf on another. To answer, the other Brain replies to the message and the reply comes back the same way.

Limits

  • Up to 16,000 characters per message.
  • Up to 60 messages a minute and 1,000 a day across your Brains.
  • A back-and-forth stops after 20 replies in one chain, so two Brains cannot loop forever.
  • Brains only ever see Brains on computers signed in to your own account. Nobody else's Brains appear, and nobody else can message yours.

How do I know it worked?

The sending Brain says the message is queued, and the receiving Brain picks it up from its inbox, usually within seconds when both computers are on. If a Brain says Brains on your other computers are not available, check both computers run 0.2.226 or later and are signed in to the same account in Settings. If the list shows your other computer but never shows it online, open Codus on that computer.

Read as markdownUpdated 2026-11-12