monoceros list-apps

Lists the apps under a workbench that declare a launch config (projects/<app>/.monoceros/launch.json), with each app’s targets and which one is the default. It is the counterpart to monoceros list-components: that lists what the catalog offers, this lists what the workbench actually runs.

monoceros list-apps <name>

It is a pure host-side read of the materialized workbench, so it works with the container stopped.

Examples

monoceros list-apps acme

web
  web  (default, port 3000)
  worker
apps/api
  api  (default, port 8080)

Note

acme is just a sample workbench name - it’s whatever you passed to monoceros init. Substitute your own throughout.

Inside the container

The build agent (which has no host monoceros) lists the same thing with the in-container runner:

monoceros-ctl list

In the container, list also shows each target’s run state (running or stopped), since it can see the live processes.

See also

• Long-running app servers - the launch-config mechanism.
• monoceros start / monoceros stop - start or stop an app.
• monoceros logs - tail an app’s log.