Skip to content

jackin workspace

Terminal window
jackin workspace <SUBCOMMAND>

Create, list, modify, and delete saved workspace definitions.

A workspace describes project access, not agent tooling. It answers: which host paths should be mounted into the container, and which agent classes are allowed to use that layout?

Terminal window
jackin workspace add <NAME> --workdir <PATH> [OPTIONS]

Save a new workspace definition.

OptionDescription
--workdir <PATH>Working directory (auto-mounted at the same path by default)
--mount <SPEC>Additional bind-mount spec (repeatable)
--no-workdir-mountDon’t auto-mount the workdir
--allowed-agent <NAME>Restrict to these agent classes (repeatable)
--default-agent <NAME>Agent class to auto-select
Terminal window
jackin workspace add my-app --workdir ~/Projects/my-app
jackin workspace add my-app --workdir ~/Projects/my-app --mount ~/cache:/cache:ro
jackin workspace add monorepo --workdir /workspace --no-workdir-mount --mount ~/src:/workspace
jackin workspace add restricted --workdir ~/app --allowed-agent agent-smith --default-agent agent-smith
Terminal window
jackin workspace list

Show all saved workspaces.

Terminal window
jackin workspace show <NAME>

Display details of a specific workspace including workdir, mounts, and agent restrictions.

Terminal window
jackin workspace edit <NAME> [OPTIONS]

Modify an existing workspace.

OptionDescription
--workdir <PATH>Update the working directory
--mount <SPEC>Add a mount (repeatable)
--remove-destination <PATH>Remove a mount by container path (repeatable)
--allowed-agent <NAME>Grant agent class access (repeatable)
--remove-allowed-agent <NAME>Revoke agent class access (repeatable)
--default-agent <NAME>Set default agent
--clear-default-agentClear the default agent
Terminal window
jackin workspace edit my-app --workdir ~/new-dir
jackin workspace edit my-app --mount ~/cache:/cache:ro
jackin workspace edit my-app --remove-destination /old-mount
jackin workspace edit my-app --allowed-agent chainargos/backend-engineer
jackin workspace edit my-app --default-agent agent-smith
jackin workspace edit my-app --clear-default-agent
Terminal window
jackin workspace remove <NAME>

Delete a saved workspace.