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 mirrorsThe 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.