# stup - Daily notes in the terminal

DevFeed: [stup - Daily notes in the terminal](<https://devfeed.tech/articles/stup-daily-notes-in-the-terminal-37457.md>)

Original publisher: [Read original article](<https://iridakos.com/programming/2020/04/20/stup-cli-notes>)

Author: Lazarus Lazaridis

Published: 2020-04-20T09:00:00Z

Content type: tutorial

Language: en

Sources: [Lazarus Lazaridis](<https://devfeed.tech/sources/lazarus-lazaridis.md>)

Topics: [Command-line interface](<https://devfeed.tech/topics/cli.md>), [Terminal](<https://devfeed.tech/topics/terminal.md>), [Code](<https://devfeed.tech/topics/code.md>), [opensource](<https://devfeed.tech/topics/opensource.md>)

Tags: [bash](<https://devfeed.tech/tags/bash.md>), [blocking](<https://devfeed.tech/tags/blocking.md>), [cli](<https://devfeed.tech/tags/cli.md>), [code](<https://devfeed.tech/tags/code.md>), [linux](<https://devfeed.tech/tags/linux.md>), [meetings](<https://devfeed.tech/tags/meetings.md>), [opensource](<https://devfeed.tech/tags/opensource.md>), [productivity](<https://devfeed.tech/tags/productivity.md>), [programming](<https://devfeed.tech/tags/programming.md>), [scripts](<https://devfeed.tech/tags/scripts.md>), [terminal](<https://devfeed.tech/tags/terminal.md>), [tools](<https://devfeed.tech/tags/tools.md>)

## AI overview

The article introduces stup, an open-source command-line tool for recording, organizing, and retrieving daily work notes from a terminal. It explains the tool's note categories, date-based storage, and commands for adding, viewing, and listing notes over time.

## Source excerpt

Over the past few years I have been participating in Stand-up meetings and it took me some time to find a convenient and effective way for keeping notes about what I was doing every day. I needed to be able to: keep notes on the issues I worked on, the meetings I participated in and stuff that blocked my work easily access these notes based on their date have an overview of what I did for example the last week all of the above from inside a terminal without having to manually structure and update a single document having to manually create a document for each day stup I created stup (the name derives from stand-up), an opensource CLI tool that deals with these issues and allows to easily save, access and organize my notes. The source code of the project is available on GitHub here. Usage examples Find below some examples showing the most important usage of stup. Adding notes # Adding a note to the default category at current date stup add -n "Worked on issue #ABC123" # Adding a note to the default category setting the current date explicitly stup add today -n "Worked on issue #ABC123" # Adding a note to the meetings category stup add today -c "meetings" -n "2 hours with @phoebe for the project kick off" # Adding a note to the blocking category for April 10th, 2020 stup add @ 2020-04-10 -c "blocking" -n "connectivity issues" Showing notes # Showing yesterday's notes $ stup # Showing yesterday's notes explicitly setting the date $ stup yesterday # Showing today's notes $ stup today # Showing notes on a specific date $ stup show @ 2020-04-18 # Showing notes on a specific date for the meetings category $ stup show @ 2020-04-18 -c "meetings" Retrieving all notes for a period of time # List current week's notes stup log week # List previous week's notes stup log previous-week # List notes between January 20th, 2020 and March 2nd, 2020 stup log --from 2020-01-20 --to 2020-03-02 # List meeting notes between January 20th, 2020 and March 2nd, 2020 stup log --from 2020-01-20 -