Worque

Build Status Gem Version

Worque is a CLI which is helpful to manage your daily notes.

  • Ever stunned when your boss suddenly asked what you've done yesterday?
  • Wanna check/note your daily tasks without exiting your favourite editor VIM?
  • Something to report on daily stand-ups?

Then worque is definitely a right tool for you!

HOW IT WORKS

INTRO

WITH VIM

INTRO VIM

Installation

DO NOT add this to your Gemfile

Install it by

$ gem install worque

Quick start guide

CLI

worque todo

Explicitly declare your path

worque todo --path /path/to/your/notes

Or you might want to put it in the global configuration file ~/.worquerc

{
  "path": "/path/to/your/notes"
}

I often prefer mapping notes to my Dropbox like this:

{
  "path": "~/Dropbox/Notes/Todos"
}

Then executing the command below will create a today's note.

worque todo --for today
# ~/notes/notes-2016-07-19.md

Or look back what's done yesterday.

worque todo --for=yesterday
# ~/notes/checklist-2016-07-18.md
# This will jump back to Friday's note if it's Monday today!

If you live in the future

worque todo --for=tomorrow
# ~/notes/checklist-2016-07-20.md

If you want to start from a default template

echo <<-EOF
List of things I need to do

* ......
* ...

Happy hacking
EOF >> /path/to/my/template

worque todo --template-path=/path/to/my/template
# ~/notes/checklist-2016-07-18.md
cat ~/notes/checklist-2016-07-18.md
> List of things I need to do
>
> * ......
> * ...
>
> Happy hacking

If you're kind of nerd and you have no life. You would rather work over the weekend than hanging out with folks, so you should enable the hardcore mode which will stop skipping weekend for you.

worque todo --for yesterday --no-skip-weekend

Moreover, you can add a task into your notes quickly without open that file.

worque todo --for today --append-task "Your task"

It's chain-able with other commands

vim worque
vim $(worque todo --for yesterday)
cat $(worque todo --for=yesterday) | grep pending

Personally I like to create a shell function today like this, so vim will automatically open the file when I type today

today () { vim $(worque todo); }
ytd () { vim $(worque todo --for=yesterday); }

worque push

Please remember to add your slack api token to your ~/.worquerc

{
  "token": "very-$3Cr3T"
}

Then the note for today will be automatically posted to the channel specified.

worque push --channel=daily-report

Alternatively, you can choose to push the note for yesterday

worque push --channel daily-report --for yesterday

VIM Integration

Add this to your VIM plugin manager

Plug 'huynhquancam/vim-worque'

Then :TD, :YTD for today and yesterday's notes respectively.

Read more about vim-worque.

View more in my dotfiles

Development

bundle install
bundle exec rake test

WORKQUE FOR WORKQUE

Something in my plan:

  • worque list: List all notes you have.
  • worque changelog: Sync your Git commits to daily notes.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/huynhquancam/worque/issues.

License

The gem is available as open source under the terms of the MIT License.