Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Command line tool to easily manage your timesheets with myintervals.com API.

branch: master
README.md

Intervals

NodeJS wrapper of Intervals API.

Install

The best way is to use npm:

npm install -g intervals

You can also clone the repository and install dependencies with npm:

git clone https://github.com/francois2metz/node-intervals.git
cd node-intervals
npm install

Dependencies

  • node-spore
  • node-optimist
  • yaml
  • futures
  • cli-table

Command line usage

See doc/intervals.ronn or type man intervals after install.

API

Get Spore description

var desc = require('invervals').description;

Get client

var client = require('intervals').createClient('secret token');

Config

An API key is needed. Go to https://xx.timetask.com/account/api/ and generate one. The config file is written in ~/.config/intervals or in $XDG_CONFIG_HOME/intervals in yaml format.

Roadmap

  • Zsh completions
  • automatic detection of billable projects
  • real calendar in interval ls

Please submit features request or pull requests :).

Changelog

  • 0.2.1 (not yet released)

    Improve range. You can use something like intervals add-time --date "last week..yesterday".

  • 0.2.0

    Add list-timers, start-timer, get-timer and delete-timer methods.

    Improve range. YYYY-MM-DD.. and ..YYYY-MM-DD now works (thanks spk).

    Replace some basic html entities to utf8. Only casual latin characters are translated.

    Date range in intervals ls, --start and --end options are no longer available.

    Add bash completion.

    Add some methods in the description file.

    Remove base64 dependency.

  • 0.1.1

    Remove dateformat dependency.

  • 0.1.0

    Date with a range. Like 2011-06-17..2011-06-14.

    List only user times with intervals ls (thanks nono).

  • 0.0.10

    Fix pager issue.

    Fix doc.

  • 0.0.9

    Use a pager if the number of results exceed the number of row in the tty.

    Show complete list of results when adding time in a project. We have an hardcoded value '42' but if the result contains more result, we made a new request.

  • 0.0.8

    List only active modules and workype.

  • 0.0.7

    Add intervals ls command.

    QuickFix bug when result list is too short.

  • 0.0.6

    Save project in config file and reuse it after with --project option.

    Add intervals -v and intervals help as shortcut of intervals --help.

    intervals without argument is an alias of intervals add-time.

    Add intervals list-projects command.

  • 0.0.5

    Add --version option.

    Add --help option.

    Add man page. man intervals.

  • 0.0.4

    Add short option -b for billable hours.

    Use XDG_CONFIG_HOME environment variable for storing config file.

    You can now set multiple date at once with multiple --date (thanks oz).

  • 0.0.3

    Options date is now optional. Default is today.

    Add missing base64 dependency.

  • 0.0.2

    Add description param.

  • 0.0.1

    Initial release with basic intervals bin.

Authors

  • François de Metz

Contributors

  • Arnaud Berthomier
  • Bruno Michel
  • Laurent Arnoud

License

AGPL v3.

Something went wrong with that request. Please try again.