Start

Agents

Operational rules for autonomous and supervised coding agents using Userland.

For agents: Treat Userland as the platform boundary. Use the manifest, runtime ctx, CLI, and API exactly as documented instead of guessing infrastructure internals.

Agent Contract

Read /llms.txt before generating files.
Prefer a complete quickstart or example over ad hoc scaffolding.
Declare managed resources in manifest.userland.json.
Use ctx.data, ctx.auth, ctx.files, ctx.secrets, ctx.jobs, and ctx.webhooks from server code.
Publish only from a trusted local or server-side tool with USERLAND_API_KEY.

Never Do

Never expose USERLAND_API_KEY in browser code.
Never print secret values.
Never invent platform internals or raw resource names.
Never serve app content from userland.fun; runtime apps use https://<app_id>.apps.userland.fun/.

Machine-readable inputs