Manage your Backlog.md tasks directly from Raycast. Browse, create, search, edit, and change task status across multiple projects without leaving Raycast.
- Backlog.md CLI — install via
npm install -g backlog.md - At least one project initialized with
backlog init
On first launch, you'll be prompted to configure two preferences:
- Project Directories — comma-separated absolute paths to your Backlog.md projects (e.g.
/Users/you/Dev/ProjectA, /Users/you/Dev/ProjectB). Tilde paths like~/Dev/ProjectAare also supported. - Backlog CLI Path — absolute path to the
backlogbinary. Defaults to/opt/homebrew/bin/backlog. If you installed via npm globally, you can find it withwhich backlog.
Browse all tasks grouped by status (To Do, In Progress, Done, Blocked). Use the action panel to filter by status or priority. If you have multiple projects configured, switch between them with the dropdown in the search bar.
| Shortcut | Action |
|---|---|
↵ |
View task details |
⇧⌘S |
Start task (In Progress) |
⇧⌘D |
Complete task (Done) |
⌘R |
Refresh list |
Full-featured task creation form supporting all backlog task create options:
- Title, description, priority, labels, assignee
- Draft mode, parent task, and dependencies
- Acceptance criteria — press
⌘Ato add more fields - Definition of Done — press
⌘Dto add more fields - References and documentation links — press
⌘R/⇧⌘Dto add more - File attachments via drag and drop (added as
--ref)
Full-text search powered by the Backlog.md index. Results are ranked by relevance and show status and priority at a glance. Press ↵ to view full task details.
Configure multiple project paths in preferences. The extension remembers your last selected project across launches using Raycast's persistent cache. Switch projects from the dropdown in the search bar (List/Search) or the form dropdown (Create).