How IssueRadar works
Set it up once in a couple of minutes. After that it quietly checks Jira and Azure DevOps for you and only speaks up when something changes.
Setting up
-
Step 1: Create a read-only token
IssueRadar signs in with a token instead of your password. For Jira Cloud that is an API token for your Atlassian account; for Azure DevOps, a personal access token with read access to work items and projects.
-
Step 2: Add a connection
Click the IssueRadar icon in the menu bar, choose Settings and open Connections. Click + and enter your Jira site address and email, or your Azure DevOps organization — plus the token, which goes straight into your Keychain.
-
Step 3: Pick projects and filters
Click Add Project… — project names autocomplete. Choose issue types, statuses, components, paths or “Assigned to me only”, and click Test to see what your filters match.
-
Step 4: Get on with your day
That’s it. IssueRadar sits in the menu bar and checks in the background. Tick Launch at Startup and it’s there every time you log in.
What happens in the background
It checks on a schedule you choose
Every 5 minutes by default; 1 minute, 15 minutes, 30 minutes, 1 hour are the other choices in Settings → General. Check Now in the menu checks immediately.
It catches up after a break
Each check asks for everything changed since the last successful check — so after your Mac has slept over the weekend, nothing is missed. It looks back at most seven days.
It compares with what it has seen
Results are compared with the issues stored on your Mac. An issue is reported when it is new, or when its status, assignee or last-updated time has changed.
It tells you what changed
One notification per changed issue. If more than eight change at once, you get a single summary instead, which opens Recent Issues.
When something goes wrong, you’ll know
An expired or revoked token doesn’t silently look like “nothing changed”. The menu’s Last check line shows which connection failed and why. If every connection fails, the next check simply tries the same time range again.
If you have turned off notifications for IssueRadar in System Settings, the menu shows Notifications disabled — click it to fix it. And the Log tab lists the result of every check in the current session.
More answers on the support page.