Skip to content
OpenDucktor Docs
openducktor.devInstall

Command palette

The command palette finds any task, workspace session, or action, and runs it without leaving the current page.

Find a task, start its next step, and answer an agent from the palette.

Open the palette

Press Cmd+K on macOS or Ctrl+K on Windows and Linux. You can also select the search button at the top of the sidebar. The shortcut does not work while another dialog is open.

The command palette with an empty search: one task in Needs you, with a Question badge, the suggested actions, and one Recent task.The command palette with an empty search: one task in Needs you, with a Question badge, the suggested actions, and one Recent task.

  1. Search

    Type to search all actions, tasks, and sessions.

  2. Workspace filter

    Search all open workspaces, or only one.

  3. Needs you

    The tasks and workspace sessions where an agent waits for you.

  4. Actions

    A short list of common actions. See All actions below.

  5. Recent

    The tasks and workspace sessions that you opened last.

  6. Key hints

    The keys for the selected row, for example Tab to see its actions.

The palette searches only open workspaces. Archived sessions do not show. Use Archived sessions to find them.

Find a task

  1. Type part of the title, the task ID, or a label.
  2. Press Enter. The latest session of the task opens. A task without a session opens its details.
The palette with the query "search". Two tasks, the Archived sessions action, and New task "search" match. Each task row shows a workspace tile, a task ID, and a status. Key hints show at the bottom.The palette with the query "search". Two tasks, the Archived sessions action, and New task "search" match. Each task row shows a workspace tile, a task ID, and a status. Key hints show at the bottom.

To search one workspace only, select the All workspaces filter, or press Option+Down on macOS or Alt+Down on Windows and Linux.

Run a task action

  1. On a task row, press Tab.
  2. Select an action, for example Start Builder. A start dialog opens.
  3. Select Start session, or Run in background to stay on the current page.
The task actions of the task Filter notes by tag: Open latest session, Open Planner session, Start Builder, Start Spec, Start Planner, Close Task, Edit Task, Open Task Details, Copy Task ID, Reset Task, and Delete Task. The list scrolls.The task actions of the task Filter notes by tag: Open latest session, Open Planner session, Start Builder, Start Spec, Start Planner, Close Task, Edit Task, Open Task Details, Copy Task ID, Reset Task, and Delete Task. The list scrolls.

To skip the action list, move to the task row with Up or Down, then press Cmd+Enter on macOS or Ctrl+Enter on Windows and Linux. It runs the main action of the task card. The palette footer shows its name, for example Start Builder.

Answer an agent

  1. On a row in Needs you, press Tab.
  2. Select Reply to question, Reply to permission request, or Reply to requests. The request shows in the palette.
  3. Answer it there. You stay on the current page. After the last answer, the palette closes.
The palette shows the question of the agent for the task Color-code tags, with its options, Reset, and Next. Esc goes back to the list.The palette shows the question of the agent for the task Color-code tags, with its options, Reset, and Next. Esc goes back to the list.

Other keys

KeysWhat it does
RightShows the actions of a task or workspace session, as Tab does. It works when the cursor is at the end of the search.
Cmd+E on macOS, Ctrl+E on Windows and LinuxEdits a task or renames a workspace session.
BackspaceIn an action list with an empty search, goes back to the main list.

Actions

A workspace action runs in the workspace that the filter selects. With All workspaces, it runs in the current workspace. Its row shows the workspace name. When an action is not available, its row shows the reason.

ActionWhat it does
New task "…"Opens the new task form with your search as the title. Shows when you type a search.
Import tasks from …Imports issues as tasks. The label names your Git provider, for example GitHub Issues. With no provider set up, the label is Import tasks from the Git provider, and the action opens Settings.
Import session from an external runtimeOpens the Import session dialog. See Import a session from an external runtime.
Open latest sessionOpens the last session that started and that works or waits for you. Without one, it opens the session that started last.
Start Builder, Request QA Review, Approve Task, …Runs a workflow step. The palette shows only the workflow actions that the task allows now. See Actions of each lane.
Reset Task, Close Task, Delete TaskAsk you first. For what each action deletes, see Reset, close, or delete a task.
Open diagnosticsChecks the harnesses, the tools, and the workspace. See Troubleshooting.
Show tourShows the tour of the main features again. OpenDucktor shows it once, after the setup.

Git actions

ActionWhat it does
Sync pull requestsReads the pull requests of one workspace or all open workspaces from the Git provider. It closes the tasks whose pull request merged.
Check merged tasksChecks whether the task branches merged into their target branch. A merged task shows Close Task on its board card.

OpenDucktor also runs both actions every 5 minutes. See Git and pull requests.

Next

Tasks and workflows

Learn the task statuses and the actions that the palette runs.

Coding sessions

Follow agents, answer them, and review their work.

Workspace sessions

Start a workspace session from the palette.

Azure DevOps

Connect an Azure Repos repository on Azure DevOps Services or Server, sign in or add a token, import work items, and follow pull requests.

Notifications

Get notified when an agent needs you, fails, or moves a task, in OpenDucktor or from your operating system.

On this page

Open the paletteFind a taskRun a task actionAnswer an agentOther keysActionsGit actionsNext