Listing your local platforms

Summary#

Shows every local platform this machine has, and which of them are running right now. Each project gets its own — the loop commands start one on demand (Running a local platform) — and Stopping the local platform stops exactly one, the project you are standing in. This is the other half: seeing what is up before deciding what to stop.

Signature#

osy instances [--running] [--all] [--stale] [--json]

Description#

Running platforms are listed first, each with its URL, the process behind it, and how long it has been up. A platform counts as running only when the process it recorded is verified to still be that process — a recorded process id on its own is not proof, because the system reuses ids, so anything unproven is reported as such rather than guessed at.

• --running lists only the platforms with a verified live server.
• --all also lists directories that have never run a server. Working in a throwaway project leaves one behind, so these accumulate; they are counted in the summary line by default and printed in full with this flag.
• --stale lists only the platforms whose project directory no longer exists.
• --json emits the list for tools and agents.

The summary line reports the total disk all of them occupy. Each carries a database of its own, so the figure grows faster than the count suggests — Reclaiming the disk your local platforms use deletes the ones you have finished with.

Listing never signals anything — it only reads. To stop one, go to its project and run osy stop, or name it directly with osy stop --devname <name>. Stopping a platform by killing processes by name is never the right move: another project's platform, or a test run, can be caught in the same sweep.

Examples#

osy instances --running     # just what is still up

osy instances --json        # the same list, for a tool to read

See also#

Reclaiming the disk your local platforms use — delete the ones you are no longer using.

Stopping the local platform — stop one of the platforms this lists.

Running a local platform — what a local platform is, and how the loop starts one per project.

Launching your app — compile and open your app, starting a platform if there isn't one.