Osy#the first language built for agents
Agents firstAgentic appsWorkflowsDurable Execution — built inSecurityTestingThe editorThe UI modelOne program

Reference

Local

23 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…

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…

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…

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…

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 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 carries its own language server and…

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…

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 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…

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…

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…

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…

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…