Use case · Remote access

Open an Agent’s computer from your terminal

When you’d rather work in a shell than watch a screen, you can. Approve SSH on an Agent’s computer and connect with the keys you already use. Open its desktop when you want to see it, jump it out into a window on your own desktop, and leave the Agent to keep an eye on whatever you leave running.

“Use my computer like your own. I’ll keep an eye on the test run and tell you if anything fails.”

Otis

Your laptop stayed cool all afternoon. The long test run happened on Otis’s computer inside the build box, and you checked on it over SSH from the kitchen table.

An afternoon on the build box
  1. 10:00 am

    Approves SSH on Otis’s computer and connects with the key that’s already on the laptop.

  2. 10:05 am

    Starts the full test suite and tells Otis “Watch this and let me know if anything fails.”

  3. 12:40 pm

    “Two tests failed in the payments module. The logs are saved next to the report.”

  4. 12:42 pm

    Jumps Otis out into a window on the desktop, opens the report, and drags the logs across to the laptop.

  5. 12:44 pm

    “Should I rerun only the failing tests, with extra logging turned on?”

How it works

The pieces behind the story

Where it runs

Otis has a private Linux computer inside the build box, kept away from the rest of your network. You reach it from the Geyser app, a browser, or your own terminal.

Who does it

You do the hands-on work when you feel like it. Otis watches the long runs and reports back.

What you control

SSH needs both the Agent’s setting and your approval, accepts public keys only, and reaches Otis’s computer, not the machine it runs on.

Running Agents on your own hardware costs nothing, and neither does remote access.

Set it up

Getting set up

  1. 1

    Install Geyser Host on the build box and give Otis a computer there.

  2. 2

    Turn on “Allow SSH access” for Otis, then approve it with “Approve SSH on this computer.”

  3. 3

    Connect with the SSH key you already use, or open Otis’s desktop in the Geyser app.

Keep exploring

More use cases

Browse all use cases
Make a start

Start with one Agent and one real job

Set up a workspace, give an Agent something useful to do, and see how far it gets.