Omnigent

Tutorial: Collaborate from Anywhere

So far everything runs on your laptop. This tutorial takes you beyond that: deploy a server so you can access your agents from your phone, share live sessions with teammates, and run agents on cloud runners that keep working after you close your laptop.

Time: 15 minutes. Requires a Railway account (free tier works).

1. Deploy to Railway

Railway is the quickest way to get a multi-user Omnigent server running.

  1. Go to railway.app and import the Omnigent repo from GitHub.
  2. Railway detects the Dockerfile and deploys automatically with a managed Postgres database.
  3. Once deployed, note your server URL (something like https://omnigent-production-xxxx.up.railway.app).

2. Connect your laptop

omni login https://your-server.up.railway.app
omni host https://your-server.up.railway.app

login authenticates you. host registers your machine so the server can dispatch agent work to it. You're now running agents through the deployed server.

3. Access from your phone

Open https://your-server.up.railway.app on your phone's browser (the same URL from step 1). You see the same web UI with the same sessions. Start a task on your laptop, check progress from your phone over lunch, answer an approval prompt from the coffee line.

4. Share a session with a teammate

In the web UI, click Share on any session. Send the link to a teammate. They open it in their browser and join in real time.

Now both of you can:

5. Run a cloud runner

Want the agent to keep working after you close your laptop? Launch a cloud runner from the web UI. The agent runs in a remote container and you check results whenever you're ready.

Set it up by adding a sandbox section to your server config. See Cloud Runner for the full setup guide.

What's next