Project

worque

0.05
No commit activity in last 3 years
No release in over 3 years
Manage your daily working list in Ruby
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 5.0
~> 10.0
~> 0.8.1
~> 2.1

Runtime

~> 0.19.1
 Project Readme

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.