Working with agents
What an AI coding agent can read about Nextly today, and what a scaffolded project tells its agent.
Read the documentation as Markdown
Four surfaces answer an agent directly. Each is served by this site and derived from the same documentation source as the pages.
/llms.txt- The index: every documentation page and blog post with a one-line description, in the llms.txt convention.
- Answers:
text/plain /llms-full.txt- The whole documentation as one Markdown document, in the order the navigation reads it.
- Answers:
text/plain /docs/<page>.md- Any documentation page as Markdown. The page's own URL answers the same way when asked with Accept: text/markdown.
- Answers:
text/markdown /docs- The documentation itself. Under every page title: Copy Markdown, and Open in ChatGPT, Claude or Cursor, which hands the assistant the page's Markdown twin.
- Answers:
text/html
Inside a project
A project scaffolded with create-nextly-app ships AGENTS.md and CLAUDE.md, a guide for whatever agent opens the repository. It covers:
- where things are: the config, the collections, the admin, the migrations, the generated types
- the commands: dev, build, the migration scripts, types:generate
- how content is read, through the Direct API on the server, and why find() is loosely typed until types are generated
- the things that surprise people: users are not a collection, a migration is one file in the project's dialect, what a shared cache entry is safe for
The guide sits between managed markers that an upgrade may replace. Notes written above or below the markers are the project's own and are kept.
New Nextly projects come with agent skills for building with Nextly (installing it, collections, authentication, deploying), written to .agents/skills/ and .claude/skills/. create-nextly-app asks first, -y adds them, and --no-skills leaves them out. They are also published with each release: npx skills add nextlyhq/nextly.
Which Nextly is this?
The documentation describes the current release and is not version-stamped. A project may run an older one, so ask it first.
npx nextly --versionThe current release is 0.0.2-alpha.71.