# Nimbus

> Nimbus hosts the web apps your agent builds, at a URL you share like a doc. Work projects are private, behind your company's Google sign-in, and shared by email; the app is told who's viewing it. Personal projects, on a personal Google account such as Gmail, are public.

To deploy an app with Nimbus, use the `nimbus` CLI:

1. Install it. It runs on macOS and Linux, installs to `~/.local/bin` without sudo, and verifies the download's checksum:

   curl -fsSL https://nimby.run/install.sh | sh

2. Run `nimbus docs` and read it before changing the app. Apps need a Dockerfile and must listen on `0.0.0.0:$PORT`; the guide has the rest.
3. Run `nimbus login`. It returns a URL: show it to the user, and run `nimbus login` again once they've approved it.
4. Ask the user whether this is a work or a personal project, then run `nimbus deploy --work` or `nimbus deploy --personal`. It prints the app's URL.
5. For a work project, run `nimbus share <email>` to give coworkers access.

Commands print JSON when their output isn't a terminal. On failure, follow `error.hint`.

Personal projects work with any Google account. Work projects need the company to be enabled on Nimbus; until it is, `nimbus login` returns `org_not_enabled`. To ask for access, email hello@nimby.run.

If the install fails in a network sandbox, allow these hosts: nimby.run, github.com, raw.githubusercontent.com, and release-assets.githubusercontent.com.

## Docs

- [Agent guide](https://nimby.run/docs.md): logging in, deploying, sharing, and how to write an app that runs on Nimbus. It's the guide `nimbus docs` prints.
- [CLI source](https://github.com/wceriale/nimbus-cli)