Reference · the tools · environments

Environment status

What it does

Show the user's environments: state, URLs, memory and CPU in use, and when each was last active, after the box's own memory and disk. Call with no argument to see all of them. This is the right tool when the user asks what they have running, when install_environment reports that they are at their cap, or when anything said the disk was full. (formerly bundle_status)

What it needs to know

environment_id · optional

Limit to one environment. Omit for all.

box · optional

Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).

session_box · optional

The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named. It changes nothing.