Jasper Handbook
jasperapp.io
English
English
  • What is Jasper
  • Quick start
    • Setup
    • Basic usage
    • Data migration
  • Use cases
    • Stream queries
    • Browse issues
    • Search issues
    • Appearance and notifications
    • Keyboard operation
    • Advanced settings
  • Reference
    • Stream
    • Filter Stream
    • Project Stream
    • Library Stream
    • System Stream
    • Sort order
    • Browser
    • Jump Navigation
    • Keyboard shortcuts
  • FAQ
  • jasperapp.io
  • jasperapp/jasper (GitHub)
Powered by GitBook
On this page
  • Open issues
  • Team mentioned issues
  • User involved issues
  • Repository and organization issues
  • Issues with milestones and labels
  • Issues containing the keywords
  • Exclusionary specification

Was this helpful?

  1. Use cases

Stream queries

Stream allows you to specify flexible queries. Here are some of the most commonly used queries.

PreviousUse casesNextBrowse issues

Last updated 4 years ago

Was this helpful?

Open issues

You can use is:open to create a Stream to view issues in an open (unclosed or unmerged) state. For example, to view an open issue in the nodejs/node repository, you can create a Stream with the following query

repo:nodejs/node is:open is:issue

However, Jasper does not recommend using is:open to create a Stream because Jasper will not be able to detect when the Stream is closed from open to closed.

This is a limitation of Jasper's polling of the GitHub Search API

So when using is:open, you should use the Filter Stream instead of the regular Stream. Filter Stream can be used to apply custom filters to a normal Stream. In the previous example, this would look like

Stream

repo:nodejs/node is:issue

Filter Stream

is:open

The same restrictions apply to close, merge and draft states.

Team mentioned issues

To view Team mentioned issues, use team:ORGNAME/TEAMNAME. For example, to view issues where @jekyll/owners are mentioned, create a Stream with a query like this

team:@jekyll/owners

User involved issues

To view issues involving a particular user, use the involves:USERNAME. For example, to see the issues involving a defunkt or jlord, create a Stream with a query like this

involves:defunkt involves:jlord

The involves:USERNAME is a useful query to specify author, assign, mention, comment, and review-requested all together.

Repository and organization issues

To view issues in a specific repository, use repo:USERNAME/REPOSITORY. For example, to view issues in the nodejs/node or electron/electron repositories, you would create a Stream with a query like this

repo:nodejs/node repo:electron/electron

To view a specific Organization issue, use org:ORGNAME. For example, to view issues of the nodejs or electron Organization, you can create a Stream with a query like this

org:nodejs org:electron

Issues with milestones and labels

You can view issues with a specific milestone by using milestone:MILESTONE_NAME. For example, to see an issue with a milestone of 13.0.0 or 14.0.0 in the nodejs/node repository, create a Stream with a query like this

repo:nodejs/node milestone:13.0.0 milestone14.0.0

You can view issues labeled with a specific label using label:LABEL_NAME. For example, to view an issue labeled build and zlib in the nodejs/node repository, create a Stream with the following query

repo:nodejs/node label:build label:zlib

If multiple labels are specified, it is an and condition.

For milestones and labels that contain spaces, specify them as milestone: "foo bar".

Issues containing the keywords

To view issues containing specific keywords, use the KEYWORD. For example, to see issues containing the octocat and github, create a Stream with the following query

octocat github
octocat OR github
octocat NOT github

Keywords including multi-byte characters and spaces should be specified as "foo bar".

Exclusionary specification

You can use -QUALIFIER to exclude a specific repository, label or etc . For example, to view issues in the nodejs organizaton that do not contain a nodejs/node repository and a bug label, you can create a Stream with a query like this

org:nodejs -repo:nodejs/node -label:bug

For more information about Filter Stream, see "" in the reference.

GitHub Docs:

GitHub Docs:

GitHub Docs:

GitHub Docs: ,

GitHub Docs: ,

GitHub Docs:

Filter Stream
Search by team mention
Search by a user that's involved in an issue or pull request
Search within a user's or organization's repositories
Search by milestone
Search by label
Limitations on query length
Exclude certain results
Exclude certain results