NAME

workspace - private tmux workspace helper for Developer Dashboard

SYNOPSIS

dashboard workspace <workspace-ref>

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the main dashboard command can keep workspace-session behaviour available without installing a generic executable into the user's global PATH.

PURPOSE

This staged helper exposes dashboard workspace, the command that creates or reuses a tmux session for one workspace and then attaches the terminal to it. It is the shell-facing entrypoint for the workspace-session workflow.

WHY IT EXISTS

It exists because workspace-session behavior is a built-in convenience feature, but the public switchboard should stay thin while the workspace module owns tmux session naming, layered env seeding, and create-vs-attach logic.

WHEN TO USE

Use this file when changing the dashboard workspace CLI contract, the staged helper handoff, or the examples contributors use to understand explicit workspace selection and session environment refresh behavior.

HOW TO USE

Users run dashboard workspace <workspace-ref> or set WORKSPACE_REF and run dashboard workspace. The staged helper forwards the request into the private runtime, which loads Developer::Dashboard::CLI::Ticket, resolves the workspace name, seeds WORKSPACE_REF, TICKET_REF, B, and OB in the tmux session environment, refreshes layered plain-directory .env values from the highest ancestor down to the current directory, creates a detached Code1 window when the session does not exist yet, and then attaches to that session.

WHAT USES IT

It is used by workspace-session workflows in the shell, by prompt integrations that rely on consistent workspace environment variables, and by regression tests that verify explicit workspace selection, env refresh, and environment fallback.

EXAMPLES

dashboard workspace
dashboard workspace DD-123
WORKSPACE_REF=DD-123 dashboard workspace
dashboard workspace feature-branch-42