You have an account on a running Zomg instance. This page takes you from a connected CLI to a box serving a page on the web.

Before you start

Install the zomg CLI and point it at your instance: Connect the CLI. When zomg health reports the API is healthy, you’re ready.

Create your first box

These commands create a box, run Linux commands in it, copy in a page, and publish it:
zomg health
zomg project current
zomg create hello-zomg
zomg exec hello-zomg -- cat /etc/os-release

cat > /tmp/zomg-hello.html <<'HTML'
<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Hello from Zomg</title></head>
  <body><h1>Hello from Zomg</h1><p>This page is served from a box.</p></body>
</html>
HTML

zomg exec hello-zomg -- mkdir -p /work/hello
zomg cp /tmp/zomg-hello.html hello-zomg:/work/hello/index.html
zomg service start hello-zomg hello-web --port 8080 --publish hello -- sh -lc 'cd /work/hello && python3 -m http.server 8080 --bind 0.0.0.0'
zomg service status hello-zomg hello-web
The published page is at https://hello.zomg.ai. Useful follow-up commands:
zomg list
zomg exec hello-zomg -- pwd
zomg service logs hello-zomg hello-web --lines 50
zomg service list hello-zomg
zomg delete hello-zomg --force

Install the agent plugin

Install the Zomg plugin so your coding agent has the Zomg skills — driving the CLI, working inside boxes, and the TypeScript SDK — ready in future sessions. Both agents install the marketplace straight from the public GitHub repo, no clone required. Install for Claude Code:
claude plugin marketplace add loopwork/zomg
claude plugin install zomg-plugin@zomg
Install for Codex:
codex plugin marketplace add loopwork/zomg
codex plugin add zomg-plugin@zomg
Then ask the agent to create a box, run something in it, or publish a service — the skills take it from there.

Where to next

Introduction

The mental model behind boxes, snapshots, and services.

Services

Run long-lived services and expose them at a public URL.