Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ttscoff/doing
https://github.com/ttscoff/doing
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ttscoff/doing
- Owner: ttscoff
- License: mit
- Created: 2014-03-15T19:32:05.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-03-26T16:00:58.000Z (3 months ago)
- Last Synced: 2024-04-18T13:47:02.463Z (about 2 months ago)
- Language: Ruby
- Size: 6.25 MB
- Stars: 1,081
- Watchers: 30
- Forks: 93
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Security: SECURITY.md
- Authors: AUTHORS
Lists
- cli-apps - doing - A command line tool for remembering what you were doing and tracking what you've done. (<a name="time-tracker"></a>Time trackers)
- my-awesome-stars - doing
- awesome-github-repos - ttscoff/doing - (Ruby)
- awesome-ruby-cli-apps - doing - Manages a plain text to-do list in the TaskPaper format. (Awesome Ruby CLIs / Workflow)
- awesome-stars - ttscoff/doing - (others)
- awesome-terminals - doing - A command line tool for remembering what you were doing and tracking what you've done. (Tools / Ruby)
- awesome-stars - ttscoff/doing - (Ruby)
- awesome-stars - ttscoff/doing - (Ruby)
- awesome-stars - ttscoff/doing - (Ruby)
- awesome-stars - ttscoff/doing - (Ruby)
- awesome-stars - ttscoff/doing - (Ruby)
- my-awesome-github-stars - ttscoff/doing - (Ruby)
- jimsghstars - ttscoff/doing - (Ruby)
- awesome-cli-apps - doing - A command line tool for remembering what you were doing and tracking what you've done. (<a name="time-tracker"></a>Time trackers)
README
# doing
[](https://rubygems.org/gems/doing)
[](https://travis-ci.org/makenew/ruby-gem)
[](./LICENSE.txt)
**A command line tool for remembering what you were doing and tracking what
you've done.**
_If you're one of the rare people like me who find this useful, feel free to
[buy me some coffee][donate]._
The current version of `doing` is 2.1.85.
Find all of the documentation in the [doing wiki][wiki].
See [what's new in Doing 2.0][doing 2].
Check out some craziness with Doing in the [iTerm status bar][status bar] and
the [Mac Touch Bar/menu bar][touch bar].
## What and why
`doing` is a basic CLI for adding and listing "what was I doing" reminders in a
[TaskPaper-formatted](https://www.taskpaper.com) text file. It allows for
multiple sections/categories and flexible output formatting.
While I'm working, I have hourly reminders to record what I'm working on, and I
try to remember to punch in quick notes if I'm unexpectedly called away from a
project. I can do this just by typing `doing now tracking down the CG bug`.
If there's something I want to look at later but doesn't need to be added to a
task list or tracker, I can type `doing later check out the pinboard bookmarks
from macdrifter`. When I get back to my computer --- or just need a refresher
after a distraction --- I can type `doing last` to see what the last thing on
my plate was. I can also type `doing recent` (or just `doing`) to get a list of
the last few entries. `doing today` gives me everything since midnight for the
current day, making it easy to see what I've accomplished over a sleepless
night.
Doing has over 30 commands for tracking your status, recording your time, and
analyzing the results.
See [the wiki][wiki] for installation and usage instructions.
## Launchbar/Alfred
The LaunchBar action requires that `doing` be available in
`/usr/local/bin/doing`. If it's not (because you're using RVM or similar),
you'll need to symlink it there. Running the action with Return will show the
latest 9 items from Currently, along with any time intervals recorded, and
includes a submenu of Timers for each tag.
Pressing Spacebar and typing allows you to add a new entry to currently. You an
also trigger a custom show command by typing "show [section/tag]" and hitting
return. Include any command line flags at the end of the string, and if you add
text in parenthesis, it will be processed as a note on the entry.
Point of interest, the LaunchBar Action makes use of the `-o json` flag for
outputting JSON to the action's script for parsing.
See the [doing project on BrettTerpstra.com][bt doing] for the download.
Evan Lovely has created an [Alfred workflow][] as well.
## Contributing
If you [create a plugin][], custom command, or hook you can share, please
[let me know][contact]. If I get a few plugin contributions, I'll set up a
second repository for them.
Feel free to fork [the repository][github] on GitHub and make pull requests
with changes. Please target the `develop` branch with pull requests.
[bt doing]: https://brettterpstra.com/projects/doing/
[donate]: http://brettterpstra.com/donate/
[github]: https://github.com/ttscoff/doing/
[wiki]: https://github.com/ttscoff/doing/wiki
[doing 2]: https://brettterpstra.com/2021/11/20/doing-2-dot-0/
[status bar]: https://brettterpstra.com/2021/10/15/see-what-youre-doing-in-the-iterm-status-bar/
[touch bar]: https://brettterpstra.com/2021/07/21/crazy-bettertouchtool-touch-bar-simulator/
[create a plugin]: https://github.com/ttscoff/doing/wiki/Creating-Plugins
[contact]: https://brettterpstra.com/contact/
[alfred workflow]: http://www.evanlovely.com/blog/technology/alfred-for-terpstras-doing/
---
PayPal link: [paypal.me/ttscoff](https://paypal.me/ttscoff)
## Changelog
See [CHANGELOG.md](https://github.com/ttscoff/doing/blob/master/CHANGELOG.md)