Paseo Gas City

A Paseo control plane for observing and operating Gas City supervisors. It adds a global Gas City surface and a workspace-scoped Factory panel.

Demo

https://github.com/user-attachments/assets/f1e82351-f11e-440e-9875-7e266d0bbdb4

Screenshots

These PNGs use a temporary local Gas City v1.4.1 fixture and an isolated Paseo test daemon. Browser DevTools verifies that no private organization names remain before each 2× capture. Wide captures omit Paseo's host navigation so the plugin surface remains the focus.

Wide overview

Work and event feed

Compact layout

What it does

• Discovers the configured supervisor and shows its cities, health, version, and diagnostics.
• Shows city-wide status and recent events, plus rig-filtered sessions and work. Convoys without upstream rig attribution remain visible in mapped workspace views.
• Maps a Paseo workspace to a Gas City rig by explicit override or longest ancestor path.
• Provides Open Gas City, Configure Gas City, and workspace Open Gas City Factory commands.
• Provides /sling <bead-id> [agent-role] to prefill a confirmed dispatch from a workspace.
• When mutations are enabled, supports confirmed bead dispatch plus wake, message, submit, stop, suspend, close, and kill session actions.

Configure

Gas City settings are host-scoped and shared by every Paseo client connected to that daemon:

• Supervisor endpoint defaults to http://127.0.0.1:8372.
• Allow remote endpoint opts into daemon-side requests to a non-loopback host.
• Enable mutations unlocks confirmed dispatch and session controls; observation remains available while it is off.
• Refresh interval and event limit control dashboard polling and bounded event pages.
• Workspace mappings override automatic longest-ancestor rig matching when a workspace is ambiguous or lives outside its rig path.

Gas City requires Paseo ^0.11.0 || ^0.12.0, whose server settings handle lets every daemon-side operation use the persisted configuration.

Settings are a safety and routing configuration, not a credential vault. Put authentication and network access controls in front of Gas City itself.

Safety defaults

The default endpoint is http://127.0.0.1:8372. Non-loopback endpoints are rejected unless Allow remote endpoint is enabled. Mutations are disabled by default, and mutation RPCs require explicit confirmation even after they are enabled. These controls are an interactive safety interlock, not an authorization boundary; Gas City remains responsible for access control. Responses, lists, and strings are bounded and validated before they reach the UI.

Paseo plugins are trusted, unsandboxed code. Review the source before installing it on the daemon host. Enabling a remote endpoint sends requests to that host from the Paseo daemon.

Requirements and limitations

• Paseo ^0.11.0 || ^0.12.0 with plugins enabled.
• A reachable Gas City v1.4.1 supervisor exposing its HTTP API.
• HTTP or HTTPS endpoints only. Credentials, query strings, and fragments are rejected.
• Automatic workspace mapping requires the workspace path to be inside exactly one discovered rig; ambiguous or unrelated paths need an explicit mapping.
• The dashboard polls at the configured interval. Supervisor events are a head snapshot, city event pages expose continuation cursors, and bounded or partial responses are marked truncated.
• Open in Paseo is unavailable with Gas City v1.4.1. POST /v0/city/{cityName}/session/{id}/messages returns a request ID and city event cursor, but /v0/city/{cityName}/session/{id}/stream emits transcript events with no request, message, or turn correlation ID. A provider would therefore be unable to assign a reply to a Paseo prompt safely when the session produces independent output.

Install

With Paseo ^0.11.0 || ^0.12.0, install the npm package:

paseo plugin install npm:@omercnet/paseo-gas-city

npm updates are reviewed before they are applied. Check for a candidate, then run the interactive review:

paseo plugin update gas-city --check
paseo plugin update gas-city

Start or confirm the Gas City supervisor before opening the plugin:

gc start /path/to/city
gc status /path/to/city --json
paseo plugin ls

paseo plugin ls must report gas-city as running with no load error.

Open Gas City from the sidebar or Command Center. Configure the supervisor endpoint and optional workspace mappings under Gas City settings. In a workspace, open the Factory panel for the mapped rig.

Develop

bun install
bun run check
bun run typecheck
bun run test
bun run test:coverage

Standalone ZIP archives are retired. Releases publish npm tarballs with npm provenance from the release workflow.

Release Please maintains the package version, changelog, component tag, and GitHub release. Tags use paseo-gas-city-v<version>.