Shortcuts

Shortcuts are custom commands that appear in the task detail dialog and in Command Terminal windows. Click a shortcut to launch an editor, open a git tool, run a script, or anything else you can do from the command line.

Adding Shortcuts

Open Settings > Shortcuts (per-project). You have two options:

1. Presets - click the Presets dropdown to pick from built-in shortcuts for popular tools
2. Add Shortcut - create a blank shortcut and fill in the label, command, and icon

Built-in Presets

Presets are filtered by your operating system. Available categories:

Editors

• VS Code - code "{{cwd}}"
• Cursor - cursor "{{cwd}}"
• Zed (macOS/Linux) - zed "{{cwd}}"
• Sublime Text - subl "{{cwd}}"
• WebStorm - webstorm "{{cwd}}"
• IntelliJ IDEA - idea "{{cwd}}"
• Visual Studio (Windows) - auto-detects via vswhere

Git

• GitHub Desktop (Windows/macOS) - github "{{cwd}}"
• Fork (Windows) - fork open "{{cwd}}"
• Fork (macOS) - open -a Fork "{{cwd}}"
• GitKraken - gitkraken -p "{{cwd}}"
• TortoiseGit Log (Windows) - TortoiseGitProc /command:log /path:"{{cwd}}"
• TortoiseGit Commit (Windows) - TortoiseGitProc /command:commit /path:"{{cwd}}"

Files & Terminal

• File Explorer (Windows) - explorer "{{cwd}}"
• Finder (macOS) - open "{{cwd}}"
• File Manager (Linux) - xdg-open "{{cwd}}"
• Windows Terminal - wt -d "{{cwd}}"
• Terminal (macOS) - open -a Terminal "{{cwd}}"
• iTerm2 (macOS) - open -a iTerm "{{cwd}}"
• Alacritty - alacritty --working-directory "{{cwd}}"

Template Variables

Shortcut commands can use these placeholders, which are replaced at runtime:

Variable	Replaced with
{{cwd}}	Task’s working directory (worktree path or project root)
{{branchName}}	Git branch name
{{taskTitle}}	Task title (sanitized for shell safety)
{{projectPath}}	Root project path

Display Options

Each shortcut has a display setting that controls where it appears in the task detail dialog:

Option	Where it appears
Header	As a pill button in the dialog title bar
Menu	In the three-dot kebab menu
Both	In both locations (default)

Use Header for shortcuts you use constantly (like “Open in VS Code”) and Menu for less frequent ones to keep the title bar clean.

Custom Shortcuts

Click Add Shortcut to create your own. Fill in:

• Label - display name (e.g., “Deploy to Staging”)
• Command - any shell command with {{}} variables
• Icon - pick from the icon palette
• Display - where it appears in the dialog (see Display Options)

Shortcuts can be reordered by dragging.

Team vs Personal Shortcuts

Shortcuts have two scopes:

Scope	Stored in	Shared via Git
Team	kangentic.json	Yes - everyone on the project sees them
Personal	kangentic.local.json	No - local to your machine

Use team shortcuts for shared tools (editors, git workflows) and personal shortcuts for your own utilities.

Tip

Team shortcuts are part of the Board Configuration file. When you export or commit kangentic.json, shortcuts are included.

Next steps

Next: Board Configuration - shortcuts live alongside columns and transitions.

See also:

• Hotkeys - the global keyboard shortcut reference
• Command Terminal - run ad-hoc commands without creating a task
• Settings - the Hotkeys tab and other customization options