For typical projects with a Procfile or compose yaml file,
exo gui will do the right thing on first use automatically. You can manage processes and view logs in your browser.
If you've got multiple manifests (such as different manifests for each of dev and test), or if you generally prefer command line interfaces, a typical workflow looks something like this:
# Initialize a new workspace in the current directory.exo workspace init# Apply a manifest to start it's processes.exo apply ./Procfile.dev# Tail logs in your terminal.exo logs# Or only specific processes.exo logs api worker# Manipulate individual processes.exo stop workerexo restart api# Switch to a different configuration by applying a different manifest.exo apply ./compose.test.yaml# Shutdown everything and cleanup state when you're done.exo workspace destroy# If you're very, very done and don't want exo running anymore.exo exit
Workspaces - A mapping of filesystem paths. Most projects have one workspace rooted at the same directory as their checked out code. This is how
exo knows what project you're working on based on your current working directory.
If run in an unmapped directory,
exo gui will offer to create a workspace for you. You can determine the current workspace with
exo workspace, initialize a new one with
exo workspace init or delete the current workspace with
exo workspace destroy.
Components - An abstract definition of resources managed by exo. Presently, the only supported type of components are processes. Each component has a unique name within a workspace. Components are manipulated by applying manifests (see below), or with CRUD operations such as
exo new, and
Manifests - A file describing all of the components in a project. Presently, the supported manifest types are procfiles and compose files. Use
exo apply ./path/to/manifest whenever your manifest changes to make your workspace match. Components will be added or removed accordingly.
Processes - A running program. Presently, only host-machine processes are supported. Docker containers will be supported in the future.
Assuming you have a process named
myapp, here are some useful management commands:
# List processes.exo ps# Control process state.exo start myappexo restart myappexo stop myapp
Daemon - A background service that manages components and supervises processes. Most commands start this service automatically. You can start it explicitly with
exo daemon and terminate it with
Builtin documentation: Run
exo help or try passing
--help to any subcommand.