// Create prompts for sidecar workspaces. Covers prompt structure (name, ticketMode, body), template variables (ticket with fallbacks), config file locations (global vs project), and scope overrides. Use when creating or modifying prompts in sidecar config files.
| name | create-prompt |
| description | Create prompts for sidecar workspaces. Covers prompt structure (name, ticketMode, body), template variables (ticket with fallbacks), config file locations (global vs project), and scope overrides. Use when creating or modifying prompts in sidecar config files. |
Prompts are reusable templates that configure the initial context for agents when creating workspaces. They help standardize common workflows like code reviews, bug fixes, or feature implementation.
| Scope | Path | Override Priority |
|---|---|---|
| Global | ~/.config/sidecar/config.json | Lower |
| Project | .sidecar/config.json (in project) | Higher |
Project prompts override global prompts with the same name (case-sensitive match).
{
"prompts": [
{
"name": "Code Review",
"ticketMode": "optional",
"body": "Do a detailed code review of {{ticket || 'open reviews'}}.\nFocus on correctness, edge cases, and test coverage."
}
]
}
Display name shown in the prompt picker. Keep it concise.
Controls how the ticket/task field behaves:
| Mode | Behavior |
|---|---|
optional | Task field shown, can be empty (default) |
required | Task must be selected before creating |
none | Task field is hidden, prompt stands alone |
The prompt text sent to the agent. Supports template variables. Use \n for newlines.
{{ticket}}Expands to the selected task ID. Returns empty string if no task selected.
"body": "Fix issue {{ticket}}."
// With task td-abc123: "Fix issue td-abc123."
// Without task: "Fix issue ."
{{ticket || 'fallback'}}Expands to task ID, or the fallback text if no task selected.
"body": "Review {{ticket || 'all open items'}}."
// With task td-abc123: "Review td-abc123."
// Without task: "Review all open items."
Only single quotes work for fallback text:
{{ticket || 'default'}} -- works{{ticket || "default"}} -- does NOT work{
"name": "Implement Task",
"ticketMode": "required",
"body": "Begin work on {{ticket}}. Use td to track progress.\nRead the task description carefully before starting."
}
{
"name": "Run Tests",
"ticketMode": "none",
"body": "Run the full test suite. Fix any failures.\nReport a summary when complete."
}
{
"name": "Code Review Session",
"ticketMode": "optional",
"body": "Start a review session for {{ticket || 'open reviews'}}.\nCreate td tasks for any issues found."
}
{
"name": "Backlog Refinement",
"ticketMode": "none",
"body": "Start a backlog refinement session. Use td to find all tasks in the backlog starting with the oldest. For each task:\n\n1. Determine relevance - has it been implemented, is it still needed? If not relevant, comment on the task and close it. If questionable, leave open with notes.\n\n2. Update tasks with out-of-date code references to reflect the current state of the codebase.\n\nUse sub-agents to analyze multiple tasks in parallel. Present a report of findings and changes when complete."
}
If no config file exists, the app creates one with 5 built-in templates:
Press d in the prompt picker to install defaults if none are configured.
In the prompt picker, prompts show their source:
[G] - Global prompt (from ~/.config/sidecar/)[P] - Project prompt (from .sidecar/)ticketMode defaults to optional if omitted\n for newlines in prompt bodiesReference for keyboard shortcut implementation, keybinding registration, shortcut parity with vim and other TUI tools, and the complete shortcut assignment table across all sidecar plugins. Use when adding or modifying keyboard shortcuts, checking shortcut assignments, resolving key conflicts, or assessing alignment with vim conventions.
Create conversation adapters for importing AI chat history from different tools (Claude Code, Cursor, Warp, Codex, etc.). Covers the adapter.Adapter interface, caching strategies, incremental parsing, watch/FD management, and performance standards. Use when creating a new adapter, modifying adapter behavior, or debugging adapter performance issues. See references/ for Cursor DB and Warp SQLite schema details.
Release new versions of sidecar. Covers version tagging with semver, td dependency updates, go.mod validation, CHANGELOG updates, GoReleaser automation, Homebrew tap updates, and verification steps. Use when preparing or executing a release.
Writing and maintaining the Sidecar Docusaurus documentation site, including page structure, doc authoring, blog posts, styling, images, and deployment workflow. Use when writing documentation, updating the docs site, adding pages or blog posts, or working with Docusaurus configuration.
Create declarative modals using the modal library API. Covers modal types (confirm, input, select, form), sections (Text, Buttons, Input, Textarea, Checkbox, List, When, Custom), rendering with OverlayModal, and keyboard/mouse handling. Use when adding modals or dialogs to the application.
Create new sidecar plugins implementing the plugin.Plugin interface, rendering views with Bubble Tea, handling keyboard input via keymap contexts, and integrating with the app shell (footer hints, event bus, adapters). Use when creating a new plugin, modifying plugin architecture, or debugging plugin rendering/lifecycle issues. See references/ for sidebar list and fixed footer layout details.