https://github.com/nosmo/worklog
Fast personal event logging for major and minor details. Log something and get on with it
https://github.com/nosmo/worklog
brag-document
Last synced: 4 months ago
JSON representation
Fast personal event logging for major and minor details. Log something and get on with it
- Host: GitHub
- URL: https://github.com/nosmo/worklog
- Owner: nosmo
- License: agpl-3.0
- Created: 2021-11-01T11:17:29.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-25T22:42:24.000Z (almost 2 years ago)
- Last Synced: 2025-09-21T08:57:16.451Z (9 months ago)
- Topics: brag-document
- Language: Python
- Homepage:
- Size: 19.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Worklog
========
> Personal event logging for major and minor details
Worklog is a tool that accepts text input, organises it into a
dicionary organised by date and time. That's it.
Worklog was written to log simpler, invisible or lesser acknowledged
aspects of the workday. This means everything between "chat with Máire
about API onboarding workflow" to specific commands run in the process
of a multi-stage task.
The generated worklog was designed to be a way of working in parallel
and contributing to a [brag
document](https://jvns.ca/blog/brag-documents/). There's many aspects
of [glue work](https://noidea.dog/glue) that can be missed: they don't
end up on tickets and may be forgotten when it comes to writing
performance reviews or even just enumerating the ways in which you and
those you work with contributed to larger projects.
Worklog accepts input as a command line argument or via stdin. This
means worklog is a handy way to log the output of commands (when used
with the --tee argument so as to not silence output).
Operation
----------
Log an arbitrary message on the commandline:
```
$ worklog "Second pass at architecture review document diagrams"
Logged message at 20:26:15
```
Via stdin:
```
$ echo "Spun around in my chair a bunch" | worklog
Logged message at 20:26:39
```
Capture a command:
```
echo "lmao" | toilet | worklog
Logged message at 20:27:01
```
Worklog defaults to saving the log at ~/.worklog.json.
The log is stored as a simple dictionary of dictionaries keyed by date
and time respectively.
Configuration
-------------
[Faic](https://www.teanglann.ie/en/fgb/faic).
Author
----------
Hugh Nowlan