NAME

shell - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard shell ...

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the public dashboard entrypoint can stay a thin switchboard.

PURPOSE

This staged helper exposes dashboard shell, which prints the shell bootstrap snippet for bash, zsh, POSIX sh, PowerShell, or pwsh. It is the CLI surface for shell integration features such as cdr, which_dir, and prompt wiring.

WHY IT EXISTS

It exists because shell bootstrap generation is a built-in dashboard feature, but the generated code should come from the private helper runtime instead of from handwritten shell fragments in the public entrypoint.

WHEN TO USE

Use this file when changing supported shell names, generated bootstrap content, or the handoff into the shared shell-generation logic.

HOW TO USE

Users run dashboard shell bash, dashboard shell zsh, dashboard shell sh, or the PowerShell variants, then evaluate the printed snippet in their shell startup flow.

WHAT USES IT

It is used by developers integrating the dashboard into their shell prompt and navigation flow, by shell smoke tests, and by docs showing how to enable cdr and prompt rendering.

EXAMPLES

Example 1:

dashboard shell bash

Run the public built-in command path that stages or re-enters this helper.

Example 2:

~/.developer-dashboard/cli/dd/shell --help

Inspect the staged helper directly after dashboard init or helper extraction has populated the home runtime.

Example 3:

prove -lv t/05-cli-smoke.t t/30-dashboard-loader.t

Rerun the focused staged-helper and thin-loader tests after changing helper dispatch behavior.

Example 4:

prove -lr t

Verify that the helper still behaves correctly inside the complete repository suite.