DOCUMENTATION / PROJECT

This page documents the original repository site. You are viewing the new standalone AgentRun website, which imports its documentation content.

agent.run() website

The website lives in this repository alongside the DSL. It includes the homepage workflows, animations and original assets, interactive examples, documentation, and Pi extension preview.

Build and preview

From the repository root, with Node 22.19+:

npm ci --ignore-scripts
npm run build
npm run build:site
npm run check:site

Serve site/dist with a static HTTP server. For example, with Python 3:

python3 -m http.server 4173 --bind 127.0.0.1 --directory site/dist

Open http://localhost:4173. The preview uses recorded interpreter runs and scripted model responses; no model credentials are needed.

Where to edit

  • dist/landing.html, dist/landing.js, and the styles and motion scripts contain the homepage presentation. The build copies landing.html to index.html.
  • dist/assets/ contains the illustrations, videos, and asset provenance manifest.
  • ../docs/ and package READMEs supply generated documentation; ../examples/ supplies runnable workflows and playback data.
  • ../scripts/build-site.mjs generates pages, traces, schema copies, and example copies. PRODUCT.md and DESIGN.md record the product and visual direction.

dist contains both authored and generated files: do not delete it as a disposable build directory. Regenerate after source edits and commit the generated changes. The source download under dist/downloads/ is generated and intentionally ignored by Git.

The deployment directory is site/dist. Repository updates do not deploy the website. Public hosting and asset rights remain subject to the release checklist.