Skip to main content

Record what you are doing SIMPLY from the command line

Project description

This is a command-line tool for tracking what you’re doing as simply as possible. It’s for people who just want to describe what’s going on and move on without messing with a ‘system’.

Currently it’s in a raw, early stage. If you keep a file named ~/.now.txt for any other purpose, don’t use this.

Example:

now eating lunch
now napping

These commands append lines to ~/.now.txt, prefixed with timestamps.

If you want to use a different file instead of ~/.now.txt, create a file called ~/.nowrc with content like the following (where ~/bar is the name of the file you want to have written):

write_to=~/bar

Give an absolute path. A relative path will generate an error.

Principles:

  • Switches should not be required in normal operation.
  • The default action is to write the given message with a timestamp.
  • We don’t write to multiple different files. Just one file.
  • Messages are not parsed; they have no syntax, and no reserved words.
  • Messages have no imposed inter-relationships.
  • Always write with UTF-8 encoding.
  • Always write the same line-based format.
  • The line format should be both obvious to humans and easily machine-parseable (e.g, with regex).
  • Times are always given in UTC, with largest unit first (e.g. year-month-day).
  • Times are never tracked below the duration of 1 second.
  • now doesn’t get involved in analyzing or rendering the data it produces.

If you are interested in a fancier tool (written in Ruby and writing a customizable TaskPaper format), take a look at Doing.

Project details


Release history Release notifications

This version
History Node

0.0.6

History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

History Node

0.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
now-0.0.6.tar.gz (4.2 kB) Copy SHA256 hash SHA256 Source None Aug 31, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page