• dashboard-project-status [[https://travis-ci.org/functionreturnfunction/dashboard-project-status][https://travis-ci.org/functionreturnfunction/dashboard-project-status.png?branch=master]] [[https://coveralls.io/github/functionreturnfunction/dashboard-project-status][https://coveralls.io/repos/github/functionreturnfunction/dashboard-project-status/badge.svg?branch=master]] [[https://melpa.org/#/dashboard-project-status][file:https://melpa.org/packages/dashboard-project-status-badge.svg]] Display a git project's status in a dashboard widget.

If magit is installed, a link to the project in magit will be provided as well.

** Screenshot [[./screenshot.png]]

** Installation / Usage

*** use-package

+begin_src emacs-lisp

(use-package dashboard :config (use-package dashboard-project-status :config (add-to-list 'dashboard-item-generators `(project-status . ,(dashboard-project-status your directory))) (add-to-list 'dashboard-items '(project-status) t) (setq dashboard-items '((project-status . 10) (recents . 10) (agenda . 10)))) (dashboard-setup-startup-hook))

+end_src

*** Without use-package

+begin_src emacs-lisp

;; some time before calling dashboard-setup-startup-hook': (reqiure 'dashboard-project-status) (add-to-list 'dashboard-item-generators (project-status . ,(dashboard-project-status your directory))) (add-to-list 'dashboard-items '(project-status) t) (setq dashboard-items '((project-status . 10) (recents . 10) (agenda . 10)))

+end_src

*** Auto-Refresh Project Setting the optional second argument UPDATE for `dashboard-insert-project-status' anything non-nil will cause the project to be refreshed automatically using "git remote update".