Log in

simulo run submits to the cloud only when you’re signed in. Without a login, it writes a local package to disk and does not run it:

This wrote a local package only. Log in to submit to the Simulo cloud instead:
    simulo login

You sign in once per machine. The CLI saves your session and renews it for you.

Sign in

simulo login

The CLI prints Opening your browser to sign in... and opens Simulo’s sign-in page. Sign in, or create an account. The browser then hands the sign-in back to the CLI, which prints your email and your organization’s name and short name:

Logged in as you@example.com — Acme Robotics (acme-robotics)

You have 5 minutes to finish signing in. After that the login times out, and you run simulo login again.

The CLI saves your session in ~/.simulo/credentials, readable only by you. It renews the session automatically when it expires. If renewal ever fails, a command tells you Run: simulo login; sign in again and carry on.

Signing in without a local browser

The browser returns the sign-in to the CLI through a small server the CLI runs on your computer, on 127.0.0.1. If the CLI can’t start that server, it switches to a manual sign-in:

1. It prints a sign-in URL. Open it in a browser on any machine.
2. After you sign in, the page shows a short code and an 8-character fingerprint.
3. Paste the code, then the fingerprint, into the waiting terminal.

The fingerprint proves the page you signed in on belongs to this login. If it doesn’t match, the login fails and nothing is saved.

Check who you’re signed in as

simulo whoami

Email:         you@example.com
Organization:  Acme Robotics
Slug:          acme-robotics

Sign out

simulo logout

This deletes ~/.simulo/credentials and asks Simulo to revoke your session. The local file is deleted even if Simulo can’t be reached.

Other Simulo environments

simulo login signs you in to Simulo’s production cloud. If you’ve been given access to another Simulo environment, Configure environments shows how to select it.

Next

Create your first app.