waiting for your computer…
Learning
MAKI learns from how sessions go — what worked, what was corrected — to get better at this.

Connect your computer

1On your computer, make sure you have a coding agent installed:
npm install -g @anthropic-ai/claude-code
# or:  npm install -g @openai/codex
# (need Node 18+ first — nodejs.org)
2Download the bridge and run it with your pairing code:
⇩ Download maki-remote-bridge.js
Save it anywhere. Already have it? Download it again — the bridge does not update itself, and the current build sends images, video, PDFs and files straight from your computer, remembers your folders, and finds Codex as well as Claude.
First: which folder? — optional, the bridge can find it
This decides where your prompts run and which conversations show up in your session list.
You do not need to know the path. The bridge looks for the folder your most recent Claude conversation is in, and prints what it chose: workdir : C:\Users\you\my-project (found). If that is the right one, you are done.
To choose it yourself — any of these:
• On your phone, tap ⋯ › Folders and pick from the list your computer reports. It is remembered, so you only do this once.
• Add --dir to the command, once — --dir C:\Users\you\my-project. Also remembered, so you can drop it next time.
• Do not know the full path? Ask the agent that is already on that computer — open Claude Code or Codex in the folder you want and ask “what is the full path of this folder?”. You need one of them installed for any of this to work, so it is always available. (pwd on macOS/Linux, Get-Location in PowerShell, do the same job.)
• Managing several computers? Computers & folders lists every machine on your account with its folders, and builds the command for each one.
Avoid your home folder. It collects every conversation that ever defaulted there — including ones started by scheduled jobs — and they are hard to tell apart from your own. The bridge warns you if it lands somewhere crowded.
Name this computer — it goes into the command below and labels the machine in ⋯ › Computers, so several machines never look alike.
Saved to your account — every future pairing code will already have this name on it.
Which computer are you connecting to?
Windows PowerShell. Use curl.exe, not curl — in PowerShell curl is an alias for Invoke-WebRequest, which has no -O flag and will error.
curl.exe -O https://makiai.app/os-assets/maki-remote-bridge.js
node maki-remote-bridge.js ------
macOS or Linux (bash / zsh). Here plain curl is the real curl.
curl -O https://makiai.app/os-assets/maki-remote-bridge.js
node maki-remote-bridge.js ------
About the pairing code, pasting, and --dir
The pairing code is 6 characters, uppercase letters and digits — like A1B2C3. Type it bare: no quotes, no dashes, no angle brackets. It is the third word on the line, the last thing on the line unless you add options. Once you tap New code below, yours is filled into the command above already — just copy it.
After pasting, the first line runs on its own. The last line waits at the prompt — press Enter once more to finish connecting. A waiting prompt there is expected, not a failed paste: pasting multi-line text runs each line at its newline, and the last line has no newline after it. Pasting again would run the download twice.
--dir is optional. Leave it off and the bridge finds your folder; add it to say exactly which one. Either way it is remembered — see First: which folder? above.
Options — none of them required
Optional extras — add either to the end of the command. Order does not matter, as long as the pairing code stays third and --dir keeps its folder after it.
--no-stream — live output is on by default now, so this is only for making the answer arrive in one piece instead of as it is written. Claude Code only either way — Codex has no equivalent and is unaffected. --stream still works if it is in an older command you saved.
--name "Studio PC" — what this computer is called in Computers (the ⋯ menu), so you can pair several machines and switch between them. Without it the bridge uses your computer's own hostname, which is fine but means three machines can look alike.
You do not need any of these. The command above is complete: live output is on by default, your folders are remembered against this computer, and a name you give a machine once is kept. Everything here is for changing something deliberately.
Drop --stream if you are running Codex — it does nothing there, and the bridge says so rather than failing.
Add --dir here too if you want to name the folder yourself — it can go anywhere after the pairing code.
To update the bridge, stop it first. A bridge that is already running keeps the copy it loaded at startup, so re-downloading over the top changes nothing until you restart it. Press Ctrl-C, download again, then run it again.
Check it worked by reading the first lines it prints: 
MAKI REMOTE BRIDGE  (2026-08-28.4)
  machine : Studio PC
  stream  : on (live output)
  mode    : permission-mode auto
If the version is older than 2026-08-28.4 the download did not replace the file — you are probably in a different folder from the one you saved it into. If the stream line is missing, the flag did not register.
YOUR PAIRING CODE
······
tap "New code" (you must be logged in on makiai.app)
The bridge tells you if anything's missing (Node, Claude Code, or Codex) and the exact command to fix it. Keep its window open while you work. Only prompt text and the output travel through MAKI — never your API keys or files.