lisp>> counsel-org-clock>> 返回
项目作者： akirak

项目描述 ：
Counsel (Ivy) interface for org-clock
高级语言： Emacs Lisp
项目地址: git://github.com/akirak/counsel-org-clock.git
创建时间： 2018-03-13T07:13:02Z
项目社区：https://github.com/akirak/counsel-org-clock
开源协议：GNU General Public License v3.0
下载


Build Status
MELPA

counsel-org-clock

Counsel Org Clock provides commands for displaying org clock entries via Counsel (Ivy) interface.

Features

This package contains the following two commands:

  • When you are clocking in a task, counsel-org-clock-context displays the task, its ancestors, and its descendants via Ivy. When not clocking in, this function behaves the same as counsel-org-clock-history.
  • counsel-org-clock-history displays entries in org-clock-history variable via Ivy.
    • With a prefix argument, counsel-org-clock-history rebuilds the history from clock entries in org-agenda-files before displaying it.
  • counsel-org-clock-goto command is a replacement for org-clock-goto which lets you navigate to the active clock and through the clock history.

Screenshots

counsel-org-clock-context:

counsel-org-clock-context

counsel-org-clock-history:

counsel-org-clock-history

Actions for the selected headline (M-o):

actions

Prerequisites

  • Emacs 24.3 (with Org)
  • Ivy
  • dash.el

Installation

This package is available on MELPA as counsel-org-clock.

Usage

counsel-org-clock-context and counsel-org-clock-history

Run counsel-org-clock-context or counsel-org-clock-history. By default, these functions jump to a selected headline. You can change the default action by setting counsel-org-clock-default-action variable.

You can also access a bunch of alternative actions from M-o, including:

  • Narrow the buffer to the selected entry or show it in an indirect buffer
  • Change the todo state
  • Set tags
  • Set a property
  • Clock in/out
  • Store a link

If you run counsel-org-clock-history with a prefix argument, it reads clock entries in org-agenda-files and rebuilds org-clock-history variable before displaying the history contents.

counsel-org-clock-goto

There is also counsel-org-clock-goto command. It behaves as follows:

  • Without a prefix argument, this command lets you jump to the active clock.
  • With a universal prefix argument (C-u), it calls counsel-org-clock-context.
  • With two universal prefix arguments (C-u C-u), it runs counsel-org-clock-history, which lets you browse your clock history.
  • With three universal prefix arguments (C-u C-u C-u), it runs counsel-org-clock-history with an argument. That is, it lets you browse the clock history after rebuilding it from org-agenda-files.

You can also customize what this command does when there is no active clock.
If you set counsel-org-clock-goto-fallback-function to a function, the command calls the function when there is no active clock.

I bind M-g M-j to this command:

  1. (global-set-key (kbd "M-g M-j") #'counsel-org-clock-goto)

Alternatives

Thanks

License

GPL v3