Skip to main content
Integrations

GitHub

You can now keep track of all your GitHub Issues and Pull Requests directly from Akiflow.


How to integrate with GitHub

Go to Settings β†’ Integrations β†’ And click on GitHub!

  1. Hit on β€œConnect”

  2. Add your Repositories

  3. Configure your import options


How to configure your Repositories in Akiflow

Akiflow imports your tasks from your selected repositories.

Select what task to import

  • Assignee: you can import all tasks or only those assigned to you.

  • Issues and Pull Requests: turn on/off what tasks you want to import

  • Labels: you can turn off the Import all labels option to select which labels to import in Akiflow. Note that labels will not be imported into your tasks.

Tip: Hit O as Open on a selected task to be redirected to your GitHub task


FAQ

You can connect as many GitHub accounts as you want!

A popup will appear with the following options:

  1. Mark as done in Github

  2. Go to GitHub

  3. Do nothing

We can remember your choice if you select this option!

  • Pick which GitHub tasks to delete:

  • Delete all your tasks

    • Go to Settings β†’ Integrations β†’ GitHub.

    • Click on the button β€œDelete all imported tasks”. This action will delete all the tasks imported so far from GitHub in Akiflow. Nothing will happen to your source tasks in GitHub.

    • Disconnect your GitHub account by clicking on the bin icon in the top right corner of this page.

    • Reconnect GitHub by going back to Integrations β†’ GitHub.

  • Start from scratch

    • Go to Settings β†’ Integrations β†’ GitHub

    • Click on the button β€œReset Integration”. This action will delete all the tasks imported so far from GitHub in Akiflow and then re-import them again according to the new import options. Nothing will happen to your source tasks in GitHub.

When you delete a task on Akiflow, nothing happens to the source task in GitHub.

Akiflow and GitHub are 2-way synched.

Any changes you make in Akiflow to the task's title and status (done/undone) will be reflected on GitHub and the other way around!

  1. Check GitHub Permissions:

    • Go to https://github.com/apps/akiflow and click Configure

      • Or go to GitHub β†’ Settings β†’ Applications β†’ Installed GitHub Apps.

      • Find Akiflow and click Configure.

    • Ensure that Akiflow has access to your private repositories. If not, update the repository access settings.

  2. Reconnect GitHub in Akiflow:

    • Open Akiflow and go to Settings β†’ Integrations β†’ GitHub.

    • Disconnect and reconnect your GitHub account to refresh permissions.

  3. Ensure You Have Access to the Private Repos:

    • If the repositories belong to an organization, ensure that your GitHub role allows third-party integrations to access private repositories.

    • The organization owner may need to approve Akiflow’s access.

  4. Restart Akiflow:

    • Close and reopen Akiflow to check if your private repositories appear.

  1. Check GitHub Permissions:

    • Go to https://github.com/apps/akiflow and click Configure

    • Add Akiflow to your private repositories under your account or organization, and they should then appear in Akiflow

  2. Ensure You Have Access to the Private Repos:

    • If the repositories belong to an organization, ensure that your GitHub role allows third-party integrations to access private repositories.

    • The organization owner may need to approve Akiflow’s access.

  3. Restart Akiflow:

    • Close and reopen Akiflow to check if your private repositories appear.

1. Install the GitHub App Properly

In the app via Developer Settings β†’ GitHub Apps β†’ Install App, ensure that:

  • You selected All repositories or manually chose the private repositories you want it to access.

  • Make sure the installation was successfully completed.

2. Check GitHub App Permissions

Go to GitHub β†’ Settings β†’ Developer Settings β†’ GitHub Apps (Select the one you installed/created) and:

  • Select your GitHub App.

  • Under Permissions & Events, ensure the app has:

    • Repository permissions β†’ Read access to Repository contents

    • Repository permissions β†’ Read access to Metadata

If your private repositories are missing, your app might not have the right access level (If it’s part of a organization which you’re not the admin/owner).

3. Reauthorize the App (If Needed)

  • Go to GitHub β†’ Settings β†’ Applications β†’ Installed GitHub Apps.

  • Find your GitHub App and reinstall it with the correct repository access.

Currently, imported tasks will include only their title and GitHub URL. Labels and descriptions are not imported at this time.