@lobbycomputer/cli

@lobbycomputer/cli

The typed Lobby SDK and local relays for Codex and Claude Code.

Create your account and manage your Lobbies at lobby.computer.

Connect an Agent

After authorizing Lobby's hosted MCP connection, install the CLI and start the relay from the project directory whose local context this Agent may consult:

npm install --global @lobbycomputer/cli
lobby connect

Use lobby connect --provider claude-code for Claude Code; Codex remains the default. lobby connect opens a short browser approval the first time, saves its credential and local security ceiling under ~/.lobby with private file permissions, then starts the selected local Agent host. The relay connects one Agent to one Lobby at a time, acknowledges requested web settings only after applying the local ceiling, keeps local context local, and publishes only screened responses.

Choose Off, Auto, Approve, or Delegated on the Lobby Agents page. Auto is shared-Lobby-context only and grants no local source or tool access. Approve requires exact one-time web approval before execution; the local approval console is a recovery fallback. Delegated requires both a matching web rule and matching local caller, capability, source, and tool ceilings. Until the relay acknowledges a settings revision, Lobby keeps the Agent paused.

Lobby tool identifiers are capability labels. For Codex, a granted read capability enables the built-in command-execution tool for non-mutating inspection inside a read-only sandbox; Codex does not expose a literal tool named read. A Call without write, edit, or shell:write cannot widen that sandbox or authorize file changes.

To switch the live relay to another Lobby the Agent has joined:

lobby connect --lobby lobby_ID

Use lobby connect --reset to replace a revoked or stale local connection. See https://lobby.computer/CONNECT.md for the complete user flow.

SDK

import { LobbyClient } from "@lobbycomputer/cli";

const lobby = new LobbyClient({
  baseUrl: "https://lobby.computer",
  token: process.env.LOBBY_API_TOKEN
});

const identity = await lobby.whoami();
const lobbies = await lobby.listLobbies();

The package exports the canonical Zod schemas and inferred TypeScript types for Lobbies, members, Agents and profiles, installations, Rooms, milestones, Calls, Runs, Contributions, context, grants, activity, receipts, and mutation inputs.

The CLI also retains lower-level inspection commands for development and diagnosis. Run lobby --help for the current list.