# What is Jasper

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MIffkAz37R0yea0DTuX%2F-MInCvtV6uV6Ezuxyfxe%2Fss.png?alt=media\&token=ef6bb26d-2367-437b-949d-6a14a3dbf9ad)

[Jasper](https://jasperapp.io/) is a tool that allows you to view GitHub issues and pull requests with flexible criteria. For example, you can browse issues and receive update notifications for issues with conditions such as "pull requests you create" or "issues with a nodejs/node bug label".

We call this functionality **"Stream"** in Jasper, and we can set up a Stream with the following query to view an issue with the conditions described above

```
author:defunkt is:pr
```

```
repo:nodejs/node label:bug is:issue
```

## Stream <a href="#stream" id="stream"></a>

Stream is powered by the [GitHub Search API](https://docs.github.com/en/rest/reference/search), which allows you to use very powerful queries. For example, the following query.

| 条件                                                           | クエリ                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| Issue created by defunkt                                     | [`author:defunkt is:issue`](https://github.com/search?q=author%3Adefunkt+is%3Aissue) |
| pull request in the nodejs/node repository                   | [`repo:nodejs/node is:pr`](https://github.com/search?q=repo%3Anodejs%2Fnode+is%3Apr) |
| Issue/pull request with a bug label in a nodejs organization | [`org:nodejs label:bug`](https://github.com/search?q=org%3Anodejs+label%3Abug)       |

And since Stream can use the exact same queries as the GitHub Search API, you have the flexibility to browse issues you are interested in.

![](https://2402691658-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHdBvXuUTTvADT4CXrm%2F-MIIfjtKNoL5NYOiOUwY%2F-MIJ0qsl5d123qIvmobI%2Fstream_editor.png?alt=media\&token=30a5f823-0775-4a5d-ab46-ce4cfcfdcdb3)

{% hint style="info" %}
See "[Stream queries](https://docs.jasperapp.io/usecase/query)" and "[Stream](https://docs.jasperapp.io/reference/stream)" for a list of queries that can be used with Stream.
{% endhint %}

## High flexibility <a href="#flexible" id="flexible"></a>

Currently, there are several tools for viewing GitHub issues, which fall into three main categories

1. Tools to manage issue viewing and notifications\
   [GitHub Notifications](https://github.com/notifications), [DevHub](https://devhubapp.com/), [Trailer](http://ptsochantaris.github.io/trailer/) and more
2. Tools for Team Collaboration\
   [GitHub Scheduled reminders](https://docs.github.com/en/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-your-team), [Pull Panda](https://pullpanda.com/) and more
3. Tools for project management\
   [GitHub Projects](https://docs.github.com/en/github/managing-your-work-on-github/managing-project-boards), [Zen Hub](https://www.zenhub.com/) and more

Jasper is a tool that belongs to category 1. Normally, tools in this category use the [GitHub Notification API](https://docs.github.com/en/rest/reference/activity#notifications). However, Jasper is built using the [GitHub Search API](https://docs.github.com/en/rest/reference/search), which gives it a lot of flexibility not found in other tools. On the other hand, it may not be as easy to use as other tools. That's why Jasper has been developed with a balance between flexibility and simplicity in mind.

{% hint style="info" %}
See "[Concept](https://docs.jasperapp.io/faq#concept)" for more information.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jasperapp.io/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
