Skip to content

Mirrors and thinair run

A mirror lets an agent edit a folder that lives in another app's small computer at local speed, while every command runs where the files are.

What a mirror is

A mirror is a real folder beside an agent, kept in step both ways with the files another app lends: a Component's, a Video's, or those of an app you made. The agent edits it with its own tools, at local speed. Every command it starts inside the folder runs in the app that lent it, where the files, git, the dependencies, the credentials and the dev server are.

A mirror is a cache. No .git, dependencies, build output, files git ignores or files named like credentials cross into it, and nothing runs in it.

Open one

thinair mirror --input '{"at":"native/kernel/component-8g4xljf9m4"}'
cd ~/.thinair/mirrors/component-8g4xljf9m4
thinair mirrors

The at is the app's address, as thinair files open answers it. Thinair decides where the mirror lives, ~/.thinair/mirrors/<app>-<id>, and answers its path; asking again answers the same mirror, so nothing appears in your own folders. Claude Code started in a Thinair Terminal, or by an Agent, may go into it. Claude Code started elsewhere needs the folder added: claude --add-dir ~/.thinair/mirrors. Each agent closes the mirror when it is done, and it ends once every agent that opened it has closed it. An agent on your computer itself may mirror any app. An agent in ThinairOS mirrors an app in any of your Profiles, with nothing asked.

thinair run

Claude Code in any Thinair login shell, and Codex in one in ThinairOS, run every command through thinair run. A command started inside a mirror runs in the owner, with its input, output, exit code, Ctrl-C and window size as if it ran here. A command started anywhere else runs here as usual.

Before a command goes, every edit the agent made has landed in the owner. Before it ends, every change it made there has come back. When both sides changed the same file, the owner's version wins, and the agent's is kept in ~/.thinair/mirrors/<app>-<id>.conflicts/ and named in the next command's output.

What a command gets

  • It runs as the user of the owner's small computer, never as root.
  • It takes none of the agent's secrets: only its language, terminal and colour settings.
  • It gets the owner Profile's credentials only when another app of that same Profile, away from your computer itself, keeps the mirror. A Component's commands get none.
  • What the owner sends lands only inside the mirror: never outside it, never through a link, and never as a tool's own settings (.mcp.json, Claude Code's settings and hooks, Codex's folder).

A read-only mirror takes no edit and runs no command. Untrusted code is worked on from ThinairOS, never mirrored onto your computer itself.