AGENTS.md and the Guides

Every Uniweb project has an AGENTS.md at its root: the manual for that project and its version of Uniweb, for developers and for AI agents. It holds what someone arriving from React, Next or Astro would otherwise get wrong, and a numbered procedure for any task. The rest is in guides, one subject at a time, one command away.

In a project

uniweb guide               # list the guides
uniweb guide content       # print one
uniweb guide theme --path  # print where its file is

Without a global install, run it in the project as npx uniweb guide. A tool that cuts long output can take the path and read the file instead. The guides ship with the CLI, so in a project they describe the version the project pins, and uniweb update moves them forward along with AGENTS.md.

AGENTS.md tries to fit the limits tools set on instruction files, such as Codex's project_doc_max_bytes, but a tool may still cut it. Near its top it says how to tell: it ends with the line End of AGENTS.md, and an agent that can't see that line should read the rest of the file itself.

With no project in front of you

npx uniweb@latest guide <name> works in an empty folder, and writes nothing. With no shell at all, read the files from the latest published package:

These pages and those files describe the latest release. A project that is behind should move forward with npx uniweb@latest update --yes, rather than look for older documentation.