How to switch between remote and exec mode

jailoc supports two ways to attach to a running workspace container. This guide shows how to configure them. For a full explanation of when to use each mode and the tradeoffs involved, see Access modes.

Let jailoc auto-detect (default)

By default, jailoc checks whether opencode is on your PATH:

• If found, it uses remote mode (opencode attach).
• If not found, it falls back to exec mode (docker exec into the container).

You don't need any config for this. Just run:

jailoc attach

Set a fixed mode in config

To pin a workspace to a specific mode regardless of what's on your PATH, set mode in the workspace config:

[workspaces.myproject]
paths = ["/home/you/projects/myproject"]
mode = "remote"

Valid values:

Override the mode for a single run

Use CLI flags to force a mode without changing your config:

jailoc attach --remote   # force remote mode for this run
jailoc attach --exec     # force exec mode for this run

The flag takes precedence over both the config value and auto-detection.

Understand attach behavior during rebuilds or restarts

Both modes fail fast if the opencode container stops or is replaced while you are attached.

• In remote mode, jailoc terminates the host-side opencode attach process instead of leaving it blocked against a dead container.
• In exec mode, jailoc cancels the docker exec session so your terminal is restored instead of staying stuck in a hung interactive session.

This is most noticeable when you rebuild, bake, or otherwise replace the workspace container while an attach session is active. After the attach command exits, run jailoc attach again to reconnect to the new container.