Managing GitHub Issues from Spacemacs org-mode

[practicalli-johnny]

Manage GitHub issues from an Org-mode file

Requirements

• list GitHub issues from a repository / organise by repository
• Create / read / update / delete issues in Emacs - want to be able to type details in Emacs rather than GitHub webpage
• bi-directional sync (GitHub to Emacs and Emacs to GitHub)

Options

• magit-force - create, read, update and delete issues (not using org-mode, but fully syncronized) - Practicalli Spacemacs -issues, prs section
• org-sync - bi-directional sync
• https://github.com/iensu/org-github-issues - conversion from markdown to org is not great (carrage returns, * in an issue become headings in org so should be avoided for lists), only seems to be sync'ing from GitHub to Emacs (not Emacs to GitHub)

Configure org-github-issues

Edit .spacemacs (or .spacemacs.d/init.el)

Add org-github-issues to `dotspacemacs-additional-packages using a package recipe

In dotspacemacs/user-config, add a package configuration

  ;; Org GitHub Issues
  (use-package org-github-issues
  :defer t
  :config
  (setq org-github-issues-user "practicalli-john"
        github-repositories '("practicalli/clojure"
                              "practicalli/spacemacs"
                              "practicalli/clojurescript"
                              "practicalli/clojure-web-services"
                              "practicalli/clojure-deps-edn"
                              "practicalli/doom-emacs")
        org-github-issues-org-file "~/projects/github-issues.org"
        ;; org-github-issues-tags '("data-tools" "github" "triage")
        org-github-issues-auto-schedule "+0d"
        org-github-issues-filter-by-assignee nil
        org-github-issues-headline-prefix t)
  ;; When idle for an hour loop over my projects and sync
  (mapcar (lambda (r) (run-with-idle-timer 3600 t (lambda () (org-github-issues-sync-issues r))))
          github-repositories))

• org-github-issues-tags filter issues, syncing only those issues that have one of the mentioned tags
• org-github-issues-filter-by-assignee when true, filter issues to return those assigned to the specified user account in org-github-issues-user. When nil return all issue regardless of assignment