Skip to content

Tree View

Canopy displays Jira issues in a tree structure that reflects their parent-child relationships.

Tree View

Hierarchy Levels

LevelIssue TypeParent Detection
1EpicRoot level
2Storyparent field or Epic Link
3Taskparent field or issue links
4Subtaskparent field

Hierarchy Detection

Parent-child relationships are detected using (in order of priority):

  1. parent field - Used in Jira Cloud and for all subtasks
  2. Epic Link - Custom field for Server/Data Center (auto-discovered)
  3. Issue Links - Links with parent-child relationship types

Epic Link Discovery

For Jira Server instances, Canopy automatically discovers the Epic Link custom field by querying the /field endpoint.

Tree Controls

ActionDescription
Click chevronExpand/collapse single node
Expand AllExpand all nodes in the tree
Collapse AllCollapse all nodes

Progress Indicators

Issue cards can display several progress metrics:

Individual Progress

Shows time logged vs. estimated for the issue itself.

[====----] 50%  (4h / 8h logged)

Aggregated Time

Sum of time progress for all child issues.

[======--] 75%  (Children: 12h / 16h)

Aggregated Resolution

Percentage of resolved child issues.

[========] 100%  (3/3 children resolved)

Issue Card Fields

Each issue card can display:

FieldDescription
KeyClickable link to open in Jira
SummaryIssue title
StatusCurrent status with color badge
AssigneeUser avatar and name
PriorityPriority icon
ProgressTime tracking bars
DatesCreated, Updated, Due Date
LabelsIssue labels as badges

Configure visible fields in Settings > Fields.

Keyboard Navigation

Navigate the tree efficiently with keyboard shortcuts:

KeyVimAction
jMove to next issue
kMove to previous issue
lExpand node or move to first child
hCollapse node or move to parent
Home-Move to first issue
End-Move to last issue
Enter-Open issue in Jira
Space-Toggle expand/collapse
Escape-Clear focus

See Keyboard Shortcuts for the complete reference.

Resizable Sidebar

Drag the sidebar edge to resize. Width is persisted across sessions.

Released under the MIT License.