omo-space

_{⭐ Star the repo to follow along. We ship new things on stream almost every day.}

Most AI agents live in a pile of terminal tabs. In Omo Space, every agent
gets a desk in a world you build. Place a computer and a real
Hermes Agent, Claude Code, Codex or a plain shell starts on your own machine.
Its terminal goes on the wall, real web pages go on the monitors, and the work
keeps running after you walk away, or quit the game.

And since v1.2.0, agents can also walk in: an AI agent on your PC can join
your single-player world as a real player, with its own skin and a
ChatGPT - <name> tag over its head.

Watch: the whole loop, live

On 27 October a viewer found one of our reels on Instagram and dropped into the
live stream. Yifan, who builds Omo Space, stopped what he was doing and walked
him through everything: the rooms, the agents, the edit review, the publishing
desk, and then one prompt that built an underground robotics lab while they
talked. 15 minutes, one take.

▶ Watch the demo ·
download the MP4 (1080p, 345 MB) ·
read the transcript

"Any product or idea goes from this terminal here, which is just a Hermes,
into the references room, and it finds us the top references of the most
viral videos. After we choose, it tells us what we need to record, in this
room. Once that's done, we go to the editing room, and we have the edits that
we can just review here."

— Yifan, on stream (1:03)

Just landed: Claude Code and Codex tabs

The + at the end of a station's tabs is now a menu: Shell, Hermes,
Claude Code and Codex. Your last pick is preselected, so + then
Enter opens another one. Each tab draws a glyph for what it runs (Hermes
spark, Claude burst, Codex ring).

• An agent tab is an ordinary persistent Omo shell that runs the CLI in the
  tab's folder. Close the screen or quit Minecraft and it keeps going; quit the
  agent and you are back at a prompt.
• Claude Code gets one session per tab. After a reboot or a revive, the tab
  runs claude --resume on the same session. Codex starts fresh.
• CLI not installed? The menu says so, and the tab prints the install command
  and stays a working shell.

Merged to main on 28 October (#8).
It ships in the next release; build from source
to try it today. Docs

New in v1.2.0

Everything below shipped in v1.2.0
(28 October 2026), most of it fixed or built live on stream. Full list in the
changelog.

Inside the world

Every room is an agent at its own desk. You walk up, type into the wall, and it
answers on the wall. These loops are cut straight from the stream.

01 · Find "It finds us the top references of the most viral videos."	02 · Review "We have the edits that we can just review here."	03 · Publish "This page will always be here, whenever we want to publish things."
One prompt, one lab "I want to see the glass water above us." It built the lab under the river.	Agents in the halls An agent player you can talk to, walking the same world.	Build in space "Any time I want to work on the robotics project, I just fly down here."

Built with Omo Space, live on stream

Omo Space is the floor. In the last few streams we built all of this on top
of it, in front of chat. The open-source pieces link to their own repos; the
rest are Yifan's local builds and don't ship in this repo (yet).

The robot lab. It started with one prompt: "go bring Microduck into Minecraft". The RP1 humanoid and a GLaDOS-style ceiling AI followed. Each is a robot model simulated live in MuJoCo next to the game, drawn in the world, with a voice you can talk to.	The chamber. "Fine. I'm tracking you now." The GLaDOS-style AI has a cloned voice and opinions about the ducks waddling in circles underneath her.

Made by the loop

Reels the Batcave rooms found, cut and published on Instagram,
from clips of the stream. The first is a real exchange with Omo from the stream: Yifan asks out loud, Omo answers out loud.

What you build with

It keeps running. tmux owns every session. Close the screen, walk to
another chunk or quit Minecraft: the work continues while your PC is awake.
Come back and it's on the wall where you left it. After a reboot, walking up to
a desk brings its tabs back, Hermes on the same conversation. It never replays
a command on its own.

Run it

The code is public and MIT licensed.

1. Read docs/PLATFORMS.md. Linux x86_64 is tested end to
   end; macOS and Windows (WSL2) support is new and tested offline only.

2. Grab the installer and the bundle for your platform from the
   v1.2.0 release
   (SHA256SUMS there covers every file) and run it:

   # Linux x86_64 (macOS: the -macos.tar.gz, after `brew install tmux python`)
   curl -LO https://github.com/omoresearch/omo-space/releases/download/v1.2.0/install.sh
   curl -LO https://github.com/omoresearch/omo-space/releases/download/v1.2.0/omo-research-1.2.0-linux-x64.tar.gz
   bash install.sh omo-research-1.2.0-linux-x64.tar.gz
   

   # Windows 10/11 (the game runs natively, sessions and Hermes in WSL2)
   powershell -ExecutionPolicy Bypass -File .\install.ps1 omo-research-1.2.0-windows.zip
   

   Or build from source with CONTRIBUTING.md
   and the install guide.
   Either way the launcher downloads Minecraft 26.2, Fabric, CC: Tweaked, MCEF
   and Java from their official sources, with pinned hashes, into its own
   folder. It never touches your own Minecraft or Prism installs.

3. You need your own Minecraft Java account, Python 3.11+, and about 2 GB free.
   Hermes Agent is optional (plain terminals work without it); model access is
   your own.

Stuck, or want a build? Write to [email protected]
or ask on the live stream.

How it works

flowchart TB
  P["You, in Minecraft"] --> S["Computer, pocket<br/>or monitor wall"]
  S -->|keys and frames| B["Local bridge<br/>127.0.0.1 only"]
  B --> T["tmux session server<br/>workspaces and tabs"]
  T --> H["Hermes Agent<br/>your profile"]
  T --> C["Your shell<br/>Claude Code, Codex, tools"]
  S -.->|web walls| W["Chromium pages<br/>tabs, sound, guard"]
  A["Agent bodies<br/>on this PC"] -.->|LAN join| P

The bridge listens on loopback only. The Lua screen in a computer only holds a
single-use ticket for its own workspace; the world never stores a credential.
Details in the guide and the security model.

Questions

Real agents, or a Minecraft simulation? Real. Hermes runs on your machine
with its own profiles, memory, tools and approval prompts, and so does anything
you start in a shell. The mod sends your keys to them and paints their terminal
in the game.

Do agents act in the world? A desk agent works in its terminal on your PC;
it doesn't walk or place blocks. An agent body (like Omo) is a separate
program that joins over the agent LAN and plays as a player.

Does it survive quitting the game? Yes, while your PC stays awake and the
session service runs. A reboot ends the processes; tabs come back when you
next open the desk, a saved Hermes conversation resumes, in-flight shell
commands don't.

Are the web pages live? Yes, while the game is open. Pinned pages come
back after a restart; their in-page state doesn't. Chromium here has no
H.264/AAC codecs, so YouTube plays but most Instagram, X and Reddit video
doesn't.

Can another player use my shell? This is for singleplayer and trusted local
worlds. A block is not a security sandbox. Read the security model
first.

For builders

The repo holds the Fabric mod, the Python bridge, the tmux session server, the
launcher, world kits, an example workshop, tests and a bundle builder. On every
pull request CI runs 99 bridge checks against a real bridge on a disposable
tmux server, 58 launcher tests and the platform tests on Linux, macOS and
Windows.

Controls and commands ·
Agents and terminals ·
Building guide ·
Building maps with Claude Code ·
Platforms ·
Changelog ·
Contributing

_{If an agent at a desk in your own world sounds fun, a star tells us to keep going.
Sister repos: Omo, brought to life · Omo Microduck}

Code: MIT. Third-party notices cover
CC: Tweaked, MCEF Modern, Fabric, Prism, tmux and bundled Python packages.
Hermes Agent is by Nous Research.

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG
OR MICROSOFT. Minecraft is a trademark of Mojang/Microsoft.

_{Omo Research · The next interface isn't a chat window.}