AgentUp.AUDebug
au-debug hosts the repository Desktop, Mobile web export, and docs site so agents can screenshot and inspect those UIs without a packaged install. It is a maintainer visual-debug CLI, not an orchestration owner.
Keep in view
au-debug up uses the repository Server on http://127.0.0.1:5001 because Desktop and Mobile login need it. If that URL is already ready, up reuses it and down leaves it running. Otherwise up starts a repo Server and down stops Desktop, Mobile, docs, and that Server process.
Run
From the repository root:
./au-debug up
or:
dotnet run --project AgentUp.AUDebug -- up
up streams child process logs to the terminal (prefixed [server], [desktop], [mobile], [docs]) and also writes them under .git/agent-up/au-debug/logs/. It waits at most 30 seconds for readiness, then keeps hosting until Ctrl+C or au-debug down from another terminal.
Cold Desktop compiles can exceed 30 seconds. Pass --timeout 120 for those runs. --detach returns after ready without following logs.
./au-debug up --timeout 120
./au-debug status
./au-debug desktop screenshot
./au-debug mobile screenshot
./au-debug docs screenshot
./au-debug docs screenshot /docs/workspaces --full-page
./au-debug docs screenshot /developer-guide/workspaces --heading "Orchestration MCP"
./au-debug desktop login
./au-debug mobile login
./au-debug desktop start-workspace Agent-Up
./au-debug desktop open-agent
./au-debug mobile open-agent Agent-Up
./au-debug down
status probes the hosted Server, Mobile, and docs URLs and checks that the Desktop window is present. Do not curl those ports or call xdotool from the shell; those checks belong inside au-debug.
docs screenshot captures the hosted Docusaurus site after up is ready. With no path it captures /docs/. Pass a site path under /docs/, /developer-guide/, or /design-system to inspect one page. --heading scrolls that heading into the 1440x900 viewport before capture. --full-page captures the whole document. Both flags can be used together.
Tests and builds
Visual-iteration checks run through au-debug test, not a separate dotnet test or npm test invocation. Rebuilds that agents otherwise repeat by hand — design-system dist/ generation, Mobile typecheck, and the Mobile web export — run through au-debug build. Scoped suites keep the inner loop short; test / test all is the closing pass for a visual change.
./au-debug test design-system
./au-debug test desktop
./au-debug test mobile
./au-debug test au-debug
./au-debug test architecture
./au-debug test
./au-debug build design-system
./au-debug build mobile
./au-debug build
| Suite | Runs |
|---|---|
design-system | npm run build then npm test in AgentUp.DesignSystem |
desktop | AgentUp.Desktop.Tests |
mobile | npm run typecheck, npm test, then npm run build:web in AgentUp.Mobile |
au-debug | AgentUp.AUDebug.Tests |
architecture | AgentUp.Architecture.Tests |
all | those five, in that order |
| Build | Runs |
|---|---|
design-system | npm run build in AgentUp.DesignSystem |
mobile | npm run typecheck then npm run build:web in AgentUp.Mobile |
all | those two, in that order |
--timeout defaults to 180 seconds for a scoped suite or build and 600 seconds for all.
Screenshot commands print screenshot: <path>. Login uses --password or AGENTUP_ADMIN_PASSWORD from the repository .env file.
Watchdogs
Every one-shot command and up readiness uses a 30 second watchdog by default (--timeout). up itself is allowed to keep running after ready so logs stay attached; down also has a watchdog so stop cannot hang.
Ports
| Surface | URL |
|---|---|
| Server | http://127.0.0.1:5001 |
| Mobile web | http://127.0.0.1:10102 |
| Docs | http://127.0.0.1:10100 (/docs/, /developer-guide/, /design-system) |
| Desktop | native window titled Agent-Up |
Mobile ./au-debug build mobile (or ./au-debug test mobile) must have produced a web export before up serves Mobile. Desktop is launched through run-desktop.sh.
Ownership
AgentUp.AUDebug must not take compile-time dependencies on Desktop, Mobile, Server, or CLI projects. It launches those surfaces as processes and drives windows or Chromium against them.