Skip to main content

Connect an Environment

An agent needs a wire to run on. That's an environment.

An environment is a machine you point agents at — Docker, SSH, a Codespace, or local if you must. PowerLine rides the wire inside it; the agent runs there, not on your laptop.

grackle env add prod --docker     # Docker is the default
grackle env provision prod

provision installs PowerLine, opens the wire, waits for it to go green.

grackle env list
  • connected — wire's live, agents can run.
  • sleeping — it dozed off (usually a stopped Codespace). grackle env wake prod.
  • error — the wire never came up. Check the host, provision again.

Other wires: --local (this machine), --ssh --host box --user me, --codespace --codespace-name <name>.

Already have a container running? --attach <name> runs on it without owning its lifecycle.

A wire with no agent on it is just a warm machine. → Create a Task

Deeper detail in Environments & Workspaces. Pushing credentials onto the wire is covered in Credentials. New here? Start at Installation.