Get started

Up and running in ten minutes

Sign in, connect, register your Mac. Here is every step.

  1. 1

    Sign in

    Open the cockpit and sign in with Google. During early access you may wait briefly in the queue; we email you when your account is ready.

  2. 2

    Create a space

    Each new space comes with four views: My PRs, Pending my review, My tickets (a board) and Blocked PRs.

  3. 3

    Connect GitHub

    Settings → Connections. Use OAuth, a fine-grained token, or the gh login of a registered node — that token never leaves your Mac.

  4. 4

    Connect Jira

    Settings → Connections → Jira. Your site URL plus an API token, or OAuth.

  5. 5

    Add sources

    Pick repositories, a GitHub Project, or write a JQL query. The first sync backfills recent history.

  6. 6

    Install occ and register your Mac

    Install with Homebrew on macOS or Linux, initialise it, sign the command line in, then register the machine and approve the code in your browser. Registering also installs the node as a login service (a LaunchAgent on macOS, a systemd --user unit on Linux).

                      brew install kairelio-hq/tap/occ
    occ init
    occ login https://cockpit.kairelio.com
    occ register https://cockpit.kairelio.com
                    
  7. 7

    Start a session

    Open an item, choose Start agent session, and pick the checkout.

  8. 8

    Add your first trigger

    Automation → New trigger, or start from an example workflow.

  9. 9

    Install on iPad and iPhone

    In Safari: Share → Add to Home Screen. Open it from the home screen, then Settings → Notifications.

Stuck on a step?

Tell us where — we answer every message.