Introduction

OverviewArchitectureAgent Experience

The product

This repository

Structure

Usage

Other

Apps

App

The apps/app application — the authenticated product shell, and the entity views it does not have yet

apps/app runs on port 3000 and deploys as the Cloudflare Worker opb-brain-app.

What it serves today

The authenticated shell, split into route groups by whether a session is required.

RoutePurpose
(unauthenticated)/sign-inClerk sign-in.
(unauthenticated)/sign-upClerk sign-up.
(authenticated)/The signed-in landing page.
(authenticated)/searchSearch page.
(authenticated)/webhooksWebhook management.

There are no task, run, agent or machine views. The records those views would render do not exist.

What it is designed to become

This application is the browser door. The design treats an agent driving Chrome over the DevTools Protocol as a legitimate caller, which puts four requirements on every view built here:

  • A stable data-testid on every interactive element, semantic and unchanged across restyles.
  • Deterministic URLs, so every view is addressable and shareable.
  • A markdown view of every entity, reachable by appending .md to its URL.
  • Cursor pagination with visible controls on any list an agent has to enumerate. No infinite scroll.

What it is wired to

On this page

GitHubEdit this page on GitHub