Issue sidebar & saved filters

Organize GitHub and Jira issues into custom sections you define per project.

Once you've connected GitHub or Jira, their issues show up in GridTree's sidebar. Instead of one flat list, the sidebar is built from sections — saved filters you define per project. Each section is a query with a name, and it renders as its own collapsible group of matching issues. From any of them you can open the issue or create a worktree for it.

You manage sections in Settings → GitHub or Settings → Jira, per project: add a section, name it, and either pick a preset or write your own query. Reorder them to control how the sidebar stacks.

Jira sections (JQL)#

A Jira section is a JQL query. Write {project} where you want the project key — GridTree substitutes the project you linked in settings, so the same section works across projects.

# Assigned to me
assignee = currentUser() ORDER BY updated DESC

# Recently updated
project = {project} AND updated >= -7d ORDER BY updated DESC

# Open bugs
project = {project} AND issuetype = Bug AND status != Done ORDER BY priority DESC

# Current sprint
project = {project} AND sprint in openSprints() ORDER BY updated DESC

The section editor ships presets for these and more (reported by me, in progress, to do, high priority), so you can start from one and tweak the JQL.

GitHub sections (search syntax)#

A GitHub section uses GitHub's search syntax, the same qualifiers you'd type in GitHub's own search box.

# Assigned to me
is:issue is:open assignee:@me sort:updated-desc

# Open bugs
is:issue is:open label:bug sort:updated-desc

# Unassigned
is:issue is:open no:assignee sort:updated-desc

Presets are available here too — created by me, enhancements, all open, high priority — as a starting point.

Search#

Each integration's sidebar header has a search action that opens a search view, so you can look up a specific issue on demand without adding a permanent section for it.