https://github.com/nuex/t

sh script for working with ledger timelog files
https://github.com/nuex/t

Last synced: about 2 months ago
JSON representation

sh script for working with ledger timelog files

• Host: GitHub
• URL: https://github.com/nuex/t
• Owner: nuex
• Created: 2013-04-02T17:17:44.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2019-04-03T05:10:02.000Z (over 5 years ago)
• Last Synced: 2024-07-11T01:11:21.033Z (2 months ago)
• Language: Shell
• Size: 6.84 KB
• Stars: 64
• Watchers: 4
• Forks: 18
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• my-awesome-github-stars - nuex/t - sh script for working with ledger timelog files (Shell)

README

        
# t #

## Description ##

t is a shell script for working with [ledger][]'s [timelog][] format.

## Install ##

Download and install the script to a `bin` directory that exists in your `$PATH`. For example, `$HOME/bin`:

    curl --silent -L -G https://raw.github.com/nuex/t/master/t -o ~/bin/t

    chmod +x ~/bin/t

Set the location of your timelog file:

    export $TIMELOG=$HOME/.timelog.ldg

The default location is `$HOME/.timelog.ldg`.

## Usage ##

Usage: `t `

### Actions ###

- `t in` - clock into project or last project

- `t out` - clock out of project

- `t sw,switch` - switch projects

- `t bal` - show balance

- `t hours` - show balance for today

- `t edit` - edit timelog file

- `t cur` - show currently open project

- `t last` - show last closed project

- `t grep` - grep timelog for argument

- `t cat` - show timelog

- `t less` - show timelog in pager

- `t timelog` - show timelog file

## References ##

Even though this works with [ledger][] 3, the [timelog][] format is only referenced in the [ledger][] v2 documents.  Here are a few resources about the [timelog][] format:

- [Using timeclock to record billable time][timelog]

- [timelog files][htl] - from the [hledger][] project

[ledger]: http://ledger-cli.org

[timelog]: http://ledger-cli.org/2.6/ledger.html#Using-timeclock-to-record-billable-time

[htl]: http://hledger.org/MANUAL.html#timelog-files

[hledger]: http://hledger.org/