Osy#betaRun it on Osyrin: osyrin.com

Reference

Local

53 pages.

The inner loop

The local develop-and-debug loop for an Osy# app — for the person in the editor and the coding agent at the CLI alike. Run your app on a local…

The local loop (running your app on your own machine)

Everything the `osy` CLI does to the project in front of you — run it, look at what it did, check it before you ship. The first-day mistake is…

Writing a kit — its parts, and every seam an app connects

The page to read before writing a kit. What `osy kits new` makes, and each seam in a few lines with the one page that covers it: the app's answer to…

Adding an account

Adds a user to your app on the local platform, with the roles you say it should have. Use it to give yourself an account to log in with, and to…

Asking Claude to run your Osyrin account

The toolchain ships six Claude Code skills for Osyrin Cloud, so you can ask Claude to sign you in, create an app and its environments, deploy it, add…

Checking a kit composes — osy kits check

Checks that a kit composes with the kits around it: it uses no other product kit it does not complete (KIT_REFERENCES_SIBLING), it never names a…

Checking access

Runs your app and checks that it does what its model says about access: who can read, change and delete each row, what a signed-out visitor can…

Checking every project at once — osy validate --all / --affected

One command, one verdict, for a repository that holds many projects: `osy validate --all` finds every app and package under the workspace root and…

Checking whether a theme is a stock look

`osy design check` reads the app's `theme` — its accent's hue, the page's lightness, the corner radius, the shadow and the display face — and names…

Checking your app

Checks your app against production best-practice rules and reports where it falls short — the maturity signal, beside the correctness ones. Covers…

Compiling your app

Compiles your app's source into the app on the local platform — the inner-loop compile-and-apply. It applies additive changes directly; non-additive…

Composing kits — what they give together, and what is left for you

Before any code, shows what a set of kits gives together — the bridges that arrive by themselves, every event with its handlers in the order they…

Connecting a kit — each seam with the code that connects it

Prints a kit's composition surface — every event, policy, setting, slot, contract, base, grant, extension member, action and page an app connects —…

Critiquing a page against the agent-made pages

`osy design critique` puts each wide screenshot of your app beside the references you chose (`design/refs/`) and beside a gallery of typical…

Deploying your app to an environment

Builds your app on this machine and hands it to the zone one of its organization's environments runs on — `osy deploy --env prod --server…

Drilling your app

Runs four reliability drills against your app in a real browser, on a local platform of its own that can be made to fail on purpose: every action…

Explaining your app's security

Explains your app's declared authorization in plain English — who can read, create, update and delete each entity, which fields are masked, each…

Finding a kit, and learning one from its tests

Lists the kits (packages) this project can build on — each one's contracts, the kits that implement them, and what this app wired — and opens one…

Finding a typeface by its character, and shipping it

`osy font find` searches ~1,900 open-source families by what they are like — calm, playful, geometric, humanist, a didone, handwritten — and shows…

Finding licence-clear photographs past the stock picks

`osy photo find` searches Openverse — openly licensed photographs, no key needed — under several wordings of the subject, skips the top results…

Generating the C# a native provider implements

Writes the C# interface, and the plain classes it carries, for a seam a native .NET provider implements — `IBlobStore`, `IEntitySource`…

Giving a secret its value

Declaring `app.Secrets` names a secret; it does not give it a value, and an app cannot run until something does. `osy secret set` supplies the value…

Importing a data source's schema

Writes an entity for every table a registered data source holds — at its address, with its key — as ordinary source you review, grant and commit. The…

Importing data

Loads your app's own data — the JSON files that live beside its source — into the app on the local platform. Rows are matched by key and updated, so…

Installing the editor extension

Installs the Osy# editor extension that ships with the CLI into VS Code (or a compatible editor). The extension launches the toolchain's own language…

Launching the page you're on

Press F5 in a page file and your app opens at that page, not at the home route, stopping at your breakpoints. Ctrl+F5 does the same without the…

Launching your app

Opens your app in a browser, running on the local platform. It compiles the current source first, so what opens reflects what is on disk, then opens…

Listing your local platforms

Lists every local platform on this machine and says which are still running. The build-and-test loop starts one per project on demand, so this is how…

Looking at a reference site before you design

Renders a web page the way a visitor sees it — wide (1440×900) and on a phone (390×844) — into PNGs in your project's design/refs/ folder, and prints…

Mapping your theme onto your kits — osy kit tokens --app

Prints the design tokens your app comes to once its kits are in it: every token the app or a kit reads, its final light and dark value, whether it…

Moving the running app's clock

Moves the running local app's "now" — forward a day, back an hour, or to a date you name — so you can see tomorrow's reminder fire, a deadline pass…

Opening Studio

Opens Studio — a page in your browser where you describe an app and your own Claude Code builds it, on this computer. Studio is itself an Osy# app…

Photographing a page

Takes one picture of one page of your app in a real browser — signed out or as one of its accounts, on your data or on a dev seed's world, at any…

Publishing a project to Osyrin

Puts a project from this computer on Osyrin, and later sends it its changes. You sign in with Osyrin's own sign-in, a publish is built here and…

Reading a capability's source

Prints the source of a capability you opted into with `using`. A capability's source ships inside the platform rather than in your project, so it…

Reading what your application actually used

CPU, egress, database statements — counted by the machine that ran your code, not estimated. Read from your local platform with no account, so you…

Reading your data

Evaluates one Osy# expression against your app and prints what it answered — the rows, the count, the projection. The read half of `osy run`, which…

Reading your theme

Prints everything your app's theme advertises — every group, every token, each token's value or its light/dark pair, and the style props each group…

Reclaiming the disk your local platforms use

Each local platform carries its own database, so they add up fast. This deletes the ones you are no longer using — showing you what it would remove…

Recording a run

Turns on step recording, so a trace carries the steps that LED to a failure and not only the failure itself. Faults are captured either way — you…

Running a function

Runs one of your app's own functions from the command line — to put the app in a known state, backfill a column, or kick off a job. It runs as a real…

Running a local platform

Runs a full platform on your own machine — its own database, no account, no cloud, reachable only from your computer. It is the local runtime for the…

Seeing what a page cost

Every call your app makes to the local platform reports how many database round trips answered it, beside how long it took. A duration alone cannot…

Seeing what happened when your code ran

Opens a finished run and shows what it did — each step named and pointed at its source line, the values that crossed between client and server, and…

Setting an account's password

Gives an existing account of your app a new password, and signs out everything that was signed in with the old one. Use it when a password leaked…

Signing in to Osyrin

`osyrin login` signs you in to an Osyrin in your browser, on Osyrin's own sign-in page, and keeps the sign-in where every osyrin and osy command…

Starting a project

Makes a new project that compiles — blank, or from a starter — with the instructions your coding agent works from and, for Claude, settings that keep…

Stopping the local platform

Stops the local platform serving your project — the one the build-and-test loop starts on demand. Its database stops with it, so nothing is left…

The browser for screenshots

Says whether `osy test --pixels` has a real browser to draw with on this computer, and installs what is missing once, for every project — after…

Understanding your app

Prints your app's RESOLVED model — field types bound to real types, relations wired to the entity they target, each entity's actual security posture…

Upgrading the toolchain

Replaces the osy you are running with a newer release — downloaded, checked against the release's checksums, and swapped in place — on every…

What a clean check means

`osy validate` checks your source without a server or a database, which is what makes it fast — and what puts a handful of checks out of its reach. A…

Why a workflow run is not moving

Opens one parked workflow run and says why it is sitting there — which state, which waits are outstanding, who is allowed to act on each of them…