Skip to main content

Cockpit Actions

The cockpit should guide the user to the next safe action. A blocked state without an action is a product bug unless the system can explain why no action is available.

Action Types

ActionMeaning
Open issueOpen a provider issue in a new tab.
Open pull requestOpen a provider pull request in a new tab.
Start chatStart a new assistant chat for the selected item.
Resume chatContinue the assistant thread that already worked on the item.
Copy promptCopy a provider-neutral continuation prompt.
ContinueKeep working on a thread, branch, or workspace item.
ArchiveKeep the record but remove it from active attention.
ForgetDrop an unneeded local thread or cockpit reminder after explicit user choice.
RescueInspect uncertain local changes before archive or forget.
Enable pluginEnable or install a known DevNexus plugin when policy allows it.
Run setupRun plugin setup actions when policy allows it.

Provider Actions

Provider buttons should show:

  • provider icon
  • short id
  • title when known
  • external-link affordance when opening a new tab

Example labels:

  • GitHub #42: Fix setup fallback
  • GitHub PR #66: DevNexus cockpit
  • Repository: DevNexus

Provider actions are read-only navigation unless a separate provider mutation policy explicitly allows posting, approving, merging, or cleanup.

Archive and forget are local cockpit decisions. They hide a thread from active attention by writing local cockpit state; they must not delete worktrees, branches, notes, or provider records.

Plugin enable and plugin setup controls should be visible but disabled until a trusted plugin source and setup policy exist. The disabled label should name the action, and the tooltip should name the missing policy.

Curated plugin catalogue entries can show Copy command. That copies the explicit dev-nexus workspace plugin refresh command for the current workspace; it does not run install or setup from the browser.

Assistant Actions

Assistant actions should use provider-neutral language by default. Use Start chat, Resume chat, and Copy prompt unless the user must choose between multiple assistant providers.

Prompts should be concise and specific:

  • item title
  • current decision
  • reason
  • branch or workspace when relevant
  • requested next action

Do not mention Codex unless Codex is the configured assistant provider for that action.