Skip to content
NBS Workshop

Setup · GitHub source (clone)

For Day 3 morning · runs on macOS, Linux, Windows (WSL)

Prerequisites

  • GitHub account with workspace access (request via the workshop coordinator if not already granted)
  • Git installed — verify with git --version
  • Node.js 20 or later — verify with node --version
  • pnpm installed — npm install -g pnpm
  • Claude Code installed and authenticated — see Claude Code setup

Clone

Terminal window
git clone https://github.com/metaweavehq/LIFEOSAI.git
cd LIFEOSAI
pnpm install

The first install pulls ~400 MB of dependencies. Plan for ~5 minutes on hotel Wi-Fi.

Configure

The runtime inherits the same Vertex environment variables you set for Claude Code. No additional config is needed.

If you want to point at a different LLM provider for development:

Terminal window
cp .env.example .env
# edit .env — set ANTHROPIC_API_KEY or other provider keys as needed

Run

Terminal window
pnpm dev

Opens the runtime on http://localhost:3000. The first request triggers compilation; the second is instant.

Verify

In a second terminal:

Terminal window
curl -s http://localhost:3000/api/health

Expected output:

{ "ok": true, "agents": 9, "runtime": "ready" }

The agents: 9 count confirms the AI Guardrail Lab company loaded its agents.

Branch + extend

The Day 3 afternoon exercise is to build a tenth agent or a custom front-end. The cleanest pattern:

Terminal window
git checkout -b <your-name>/day-3-experiment
# edit src/agents/your-agent.md
pnpm dev

Once it runs locally, open a pull request against main.

Troubleshooting

pnpm install hangs on the npm registry — check that registry.npmjs.org is reachable. Corporate proxies sometimes block it; use a personal hotspot as a fallback.

pnpm dev fails with EADDRINUSE — port 3000 is in use. Run lsof -i :3000 to find the process, or set PORT=3001 pnpm dev.

Tenth-agent file edits don’t hot-reload — restart the dev server. Agent definitions are cached on boot.

Vertex auth fails inside the runtime — the runtime reads the same environment variables as Claude Code. Run gcloud auth application-default login and restart the dev server.