etu

README

Etu

Etu is a simple journaling tool that uses Notion as a database.

It should be noted the main goal of Etu is to write interstitial journals. See https://betterhumans.pub/replace-your-to-do-list-with-interstitial-journaling-to-increase-productivity-4e43109d15ef for more on this topic.

Installation

Homebrew

brew tap icco/tap
brew install etu

Local Build

Build Dependencies:

• Go 1.25 or later
• https://taskfile.dev/

Build

1. git clone code
2. task build
3. ./etu

Usage

Before running you need to set NOTION_KEY. Optionally, you can set OPENAI_API_KEY to enable automatic tag generation.

• To get a Notion key go to https://www.notion.so/profile/integrations
• To get an OpenAI key (optional) go to https://platform.openai.com/api-keys

$ etu
Etu. A personal command line journal.

Usage:
  etu [flags]
  etu [command]

Available Commands:
  create      Create a new journal entry. If no date provided, current time will be used.
  delete      Delete a journal entry.
  help        Help about any command
  last        Output a string of time since last post.
  list        List journal entries, with an optional starting datetime.
  search      Search journal entries using fuzzy search.
  timesince   Output a string of time since last post.

Flags:
  -h, --help      help for etu
  -v, --version   version for etu

Use "etu [command] --help" for more information about a command.

Inspiration

Etu is the personifcation of time according to the Lakota.

Etu is inspired heavily by the work of @neauoire at wiki.xxiivv.com, Time Travelers, and the screenshots in the inspiration folder.

Other projects that inspired me:

• https://github.com/charmbracelet/glow
• https://github.com/caarlos0/tasktimer
• https://github.com/achannarasappa/ticker

History

I've rewritten this aproximately seven times. Originally I made this to be a location based blogging app. Then it turned into a time tracking app. Then into a wiki. Then another time tracking app. Then a journaling tool. First with Charm as a DB, then with SQLite, then with Notion.

Future

I've been thinking about making the AI and the backend pluggable. If you have ideas on how to do that, open a ticket and ping @icco.