Getting Started

Your First Dataset from Jira, Trello, or OpenProject

Follow this guide step by step. By the end you'll have your real project data in Cylenivo's sidebar and your first Cycle Time chart.

On this page
  1. Before you start
  2. Understanding statuses and Cycle Time
  3. Jira
  4. Trello Plugin
  5. OpenProject Plugin

Before you start

Make sure Cylenivo is installed and running. The app launches a local server in the background — it needs a moment on first start.

Don't have Cylenivo yet? Download the latest version for your platform at github.com/nobsagile/cylenivo/releases/latest.

How to open the import wizard:

Option A (new users): When you first open Cylenivo, you land on the Welcome page. Click Import my data at the bottom.

Option B: Click Settings in the bottom-left sidebar. Under the Home section, click Add new data.

Both open the same import wizard.

Understanding statuses and Cycle Time

Status order

Cylenivo imports your ticket statuses and asks you to sort them in the order work flows through your process — e.g. Backlog → In Progress → Review → Done.

Cycle Time start & end

You pick which status marks the start of active work and which marks completion. Cylenivo measures the time between those two transitions per ticket.

Lead Time

Lead Time starts from when the ticket was created (or a status you define) and ends at the same completion status. It includes queue time before work begins.

Why this matters

There are no universal "right" statuses — your team decides what counts as active work. The wizard auto-suggests a sensible default, but you can adjust it any time.

Jira

Jira is built into Cylenivo — no plugin required. Supports both Atlassian Cloud (email + API token) and Jira Server / Data Center (Personal Access Token).

Get your credentials

How you authenticate depends on where your Jira is hosted:

Atlassian Cloud (*.atlassian.net)

Go to id.atlassian.com → Security → API tokens and click Create API token. Give it any name (e.g. "Cylenivo"). Copy the token — you won't see it again.

Tip: Use your regular Atlassian account (the email you log into Jira with). The token inherits your Jira permissions — it only sees projects you can access.

Jira Server / Data Center (self-hosted)

In your Jira instance, click your avatar → ProfilePersonal Access TokensCreate token. Give it a name and set an expiry if required by your admin. Copy the token.

Note: Personal Access Tokens are a Jira Server / Data Center feature — you cannot create them at id.atlassian.com. If your Jira URL ends in .atlassian.net, use the Cloud method above.

Connect Cylenivo to Jira

In the import wizard, select Jira as your source. First choose your Authentication type, then fill in the remaining fields:

Atlassian Cloud

FieldWhat to enter
Authentication typeAtlassian Cloud (API token)
NameAny label, e.g. "My Jira"
Jira Base URLhttps://yourcompany.atlassian.net
EmailThe email you use to log into Jira
API TokenThe token you created in step 1

Jira Server / Data Center

FieldWhat to enter
Authentication typeJira Server / Data Center (Personal Access Token)
NameAny label, e.g. "My Jira"
Jira Base URLYour server URL, e.g. https://jira.yourcompany.com
Personal Access TokenThe token you created in step 1

Click Connect. Cylenivo verifies your credentials before proceeding.

Choose your project and fetch data

Enter your Jira project key — the uppercase code at the start of every ticket ID. If your tickets are named ABC-123, the key is ABC.

You can find it in the Jira board URL:

jira.yourcompany.com/jira/software/projects/ABC/boards

Optionally filter by issue types (Story, Task, Bug, Epic) and set a Completed between date range. Then click Fetch data. Cylenivo streams tickets live from Jira — larger projects take a moment.

Date range tip: Start with the last 6–12 months for a manageable first import. Without a date filter, all tickets since the beginning of the project are imported — this can be very slow for large projects.

Sort your statuses

The Sort your statuses screen shows all statuses found in your tickets. Cylenivo auto-suggests an order based on how work actually flowed. Drag them into the right order — top = first in your workflow, bottom = last.

Remove any statuses you don't need using the × button — only what you keep will appear in the next step.

Common mistake: Don't keep statuses you almost never use. If "Reopened" appears on 2 out of 500 tickets, remove it — it will skew your Cycle Time.

Set up measurement

The Set up measurement screen has two dropdowns and a measurement mode:

Question in the UIWhat to pick
Which status means work has started?E.g. "In Progress" — the moment a developer picks up a ticket
Which status means it's done?E.g. "Done" or "Released"

Below the dropdowns you'll see three measurement mode options. For most teams, keep the default Full time (incl. rework) — it captures re-opened tickets and gives the most honest picture.

Click Start analyzing. Your dataset appears in the Datasets section of the sidebar and the dashboard loads.

🎉 You're done!

Your first dataset is in the sidebar. Explore the Dashboard, Flow, Health, and Forecast views. You can adjust statuses and Cycle Time settings anytime in Settings → Configurations.

Trello Plugin

Trello support requires the Trello plugin. In Trello, each list is a status — when a card moves between lists, Cylenivo records that as a transition and calculates Cycle Time from it.

Install the Trello plugin

In Cylenivo, go to Settings → Plugins and click Browse plugins. Find Trello and click Install. No restart needed — the Trello tile appears immediately in the import wizard.

Get your API Key and Token

API Key: Go to trello.com/power-ups/admin. Click New (or select an existing Power-Up). Copy the API Key shown on the page.

API Token: Open this URL in your browser — replace YOUR_API_KEY with the key you just copied:

https://trello.com/1/authorize?expiration=never&scope=read&response_type=token&name=Cylenivo&key=YOUR_API_KEY

Click Allow and copy the token shown on the next page.

Find your Board ID

Open your Trello board in the browser. The URL looks like this:

https://trello.com/b/ABC123de/my-board-name

The short code between /b/ and the board name is your Board ID.

Connect and fetch

Open the import wizard (see above) and select Trello. A dialog opens asking for your API Key and API Token — enter them and click Connect. Cylenivo verifies the credentials, then shows the fetch form.

Enter your Board ID and click Import your tickets. After fetching, follow the same status sorting and measurement setup steps as Jira — your Trello lists become the statuses.

Archived cards included: Cylenivo imports the full card history including archived items. This gives you accurate throughput data.

🎉 You're done!

Your Trello board appears as a dataset in the sidebar.

OpenProject Plugin

OpenProject support requires the OpenProject plugin. Works with both cloud instances and self-hosted Community Edition.

Install the OpenProject plugin

In Cylenivo, go to Settings → Plugins and click Browse plugins. Find OpenProject and click Install. No restart needed — the OpenProject tile appears immediately in the import wizard.

Generate an API token in OpenProject

Log into your OpenProject instance. Click your avatar (top-right) → My AccountAccess TokensAPI. Click Generate and copy the token.

Self-hosted? Use your full instance URL, e.g. https://openproject.yourcompany.com. The token works the same way for cloud and self-hosted.

Find your project identifier

Open your project in OpenProject. The URL looks like:

https://yourinstance.openproject.com/projects/my-project/work_packages

The slug after /projects/ is your project identifier.

Connect and fetch

Open the import wizard (see above) and select OpenProject. A dialog opens asking for your credentials — enter them and click Connect. Cylenivo verifies them, then shows the fetch form.

FieldExample
Server URLhttps://yourcompany.openproject.com
API Tokenfrom My Account → Access Tokens → API
Project Identifiermy-project (from the URL)

Click Import your tickets. After fetching, follow the same status sorting and measurement setup steps as Jira.

Large projects: The default limit is 100 work packages. Increase Max Items if your project has more.

🎉 You're done!

Your OpenProject data appears as a dataset in the sidebar.

Questions or issues?

Open an issue on GitHub or check the in-app Help page (sidebar → Help).

Open an issue on GitHub