Skip to main content
Agent Lab is a React client and Express/tRPC server that hosts the Uncle Robert Consulting web app. It also carries the workflow packages, operating docs, and change-control materials that back the business. This page walks you from a fresh clone to a running dev server.

​
Prerequisites

  • Node.js 20 or higher
  • pnpm installed globally (npm i -g pnpm if you do not already have it)
  • Access to the agentlab repository on GitHub

​
Get the app running

1

Clone the repository

2

Install dependencies

Agent Lab uses pnpm as its package manager.
3

Start the dev server

This runs the tRPC server with tsx watch and serves the Vite-powered React client. Open the URL printed in the terminal to see the app.

​
Repository map

Knowing where things live makes navigation and PRs faster. The database layer is managed by Drizzle ORM. Schema lives in drizzle/, and pnpm db:push runs drizzle-kit generate followed by drizzle-kit migrate to apply changes.

​
Change control

Before shipping meaningful changes to any of the following, log the change in docs/operations/change-control-register.md:
  • workflow packages under workflows/
  • operating docs under docs/operations/
  • agent prompts
  • tracker schemas
  • kit manifests
Then validate the register:
This keeps the audit trail intact for anything that touches how the business operates. See Development for the full set of supporting commands.

​
Next steps

Development commands

Type checks, tests, builds, and change-control verification.

Site settings

Customize the docs and site presentation.