stario-create

The project tool and agent guidance for building apps with Stario. This repo tracks Stario 5. The framework itself lives at bobowski/stario.

Two things ship from here:

• The stario-create CLI (uvx stario-create, or uv tool install stario-create). It scaffolds apps, adds screens, installs the skills, updates the guide, and runs the dev tasks.
• The files it installs: AGENTS.md (the always-on guide an app keeps at its root) and skills/<name>/SKILL.md (on-demand procedures an agent loads when the task matches).

New app

uvx stario-create new my-app
cd my-app
just dev     # http://127.0.0.1:8000, reloads on change
just check   # lint, format, types, tests — run before done

new creates a uv project on Python 3.14, adds stario>=5,<6 and the dev tools, writes the feature-folder layout with one static home screen, vendors static/js/datastar.js, writes AGENTS.md, a CLAUDE.md that imports it, and a justfile (dev, serve, check, fix, test), installs the four skills into .agents/skills/, and runs the tests once. Without just, the recipes in the justfile are plain commands — run them directly.

Before the first PyPI release, run from git:

uvx --from git+https://github.com/bobowski/stario-create stario-create new my-app

curl -fsSL https://stario.dev/setup.sh | sh -s -- my-app does the same through a shim.

Growing an app

Run these at the app root:

stario-create screen settings            # static page
stario-create screen notes --live        # GET + live stream + one command
stario-create skills install             # skills into .agents/skills/
stario-create guide --check              # is AGENTS.md stale?
stario-create guide --write              # update it, keep '## This app'
stario-create check                      # ruff, format, pyright, pytest
stario-create dev                        # hot reload, no `just` needed

Every command prints JSON when stdout is piped, takes --json or --text, and writer commands take --dry-run and --force.

Skills

npx skills add bobowski/stario-create also works — it reads the skills/ tree at this repo root.

Served copies

stario.dev serves these files: /AGENTS.md, /setup.sh, /llms.txt, /llms-full.txt (the guide and the skills in one file), /skills/, and /skills/<name>/SKILL.md.

Repo layout

AGENTS.md, llms.txt, setup.sh, and skills/ sit at the root — npx skills, stario.dev, and repo browsing all read them there. The wheel embeds copies under stario_create/_data/ (hatchling force-include), so uvx works without a checkout. In a checkout, the CLI reads the root files directly, so there is one canonical copy of each file.

Changing the guide

The guide is checked against real code. examples/chat-room in the stario repo follows it. When a rule changes here, change the example there, and run its tests. A code snippet in AGENTS.md must run as written; the package tests scaffold a project and compile every generated file, and stario-create new runs the new app's tests.