Inspector

The Inspector is a browser-based tool built into the Hive controller that lets you observe and interact with running sandboxes. It gives you a terminal, a file explorer, and a timeline of every exec call — all in one view.

Opening the Inspector

Navigate to the controller web UI (http://localhost:10000 by default) and click on a running sandbox. You can also go directly to /inspect/<sandbox-id>:

index.ts

import { getOrCreateSandbox } from "hive";

const sandbox = await getOrCreateSandbox("my-sandbox", {
  image: "hive/claude-code:latest",
  fs: [{ backend: "local", mount: "/workspace", acls: [{ path: "/workspace/**", access: "rw" }] }],
});

console.log("Sandbox ID:", sandbox.id);
// Open: http://localhost:10000/inspect/<sandbox.id>

import { getOrCreateSandbox } from "hive";

const sandbox = await getOrCreateSandbox("my-sandbox", {
  image: "hive/claude-code:latest",
  fs: [{ backend: "local", mount: "/workspace", acls: [{ path: "/workspace/**", access: "rw" }] }],
});

console.log("Sandbox ID:", sandbox.id);
// Open: http://localhost:10000/inspect/<sandbox.id>

What the Inspector shows

Terminal

A full PTY-backed shell connected directly to the sandbox. Type commands, check logs, or explore the filesystem interactively — exactly as if you had SSHed in.

File Explorer

Browse, open, and edit files in the sandbox filesystem. Useful for checking what an agent has written or for making quick edits without running a command.

Timeline

A chronological list of every exec call made against the sandbox — command, exit code, duration, and stdout/stderr. Every sandbox.exec() and sandbox.execStream() call appears here automatically, built from the underlying exec.request and exec.response events. Use the timeline to trace exactly what commands an agent ran, what they returned, and in what order.

Programmatic equivalent

sandbox.getEventsStream() gives you the same data as the timeline in code. Filter on exec.request and exec.response events to replicate what the timeline shows:

index.ts

for await (const event of sandbox.getEventsStream()) {
  if (event.type === "exec.request") {
    console.log("ran:", event.command);
  }
  if (event.type === "exec.response") {
    console.log("finished:", event.request_id);
  }
}

for await (const event of sandbox.getEventsStream()) {
  if (event.type === "exec.request") {
    console.log("ran:", event.command);
  }
  if (event.type === "exec.response") {
    console.log("finished:", event.request_id);
  }
}

See Audit Log for the full list of event types.

Next: Snapshots