Use and adapt developers

Use the documented interfaces and source layout for developers. The sections below retain the README’s examples and configuration details.

Core Architecture

DWS (Developer Workspace) — Main workspace container
Chat — Core unit; every screen is built from it
Solid components — Reusable UI via props
Actions — Shown in chat with confirm/cancel flows

Project Structure

1app/                  # Next.js App Router pages
2components/
3  ag-ui/              # Design system (solid, conformer, motion, skeleton)
4  ws/                 # Chat & workspace components
5  landing/            # Landing page sections
6  profile/            # Profile components
7convex/               # Convex functions & schema
8hooks/                # React hooks
9lib/                  # Utilities & config
10docs/                 # Documentation

Commands in the root manifest

The captured package.json declares the following scripts. Run them from the directory containing that manifest.

Command	Script
`npm run dev`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next dev --port 3003'`
`npm run build`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next build'`
`npm run start`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; bunx --bun next start --port 3003'`
`npm run lint`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun eslint'`

Troubleshoot a local change

Reproduce the smallest example from the quick-start guide.
Compare required configuration and dependency versions with the README.
Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

Source and help

Project Structure

1app/                  # Next.js App Router pages
2components/
3  ag-ui/              # Design system (solid, conformer, motion, skeleton)
4  ws/                 # Chat & workspace components
5  landing/            # Landing page sections
6  profile/            # Profile components
7convex/               # Convex functions & schema
8hooks/                # React hooks
9lib/                  # Utilities & config
10docs/                 # Documentation

Commands in the root manifest

The captured package.json declares the following scripts. Run them from the directory containing that manifest.

Command	Script
`npm run dev`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next dev --port 3003'`
`npm run build`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next build'`
`npm run start`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; bunx --bun next start --port 3003'`
`npm run lint`	`bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun eslint'`