#cli #terminal #productivity #git #ideas

bin+lib eureka

CLI tool to input and store your ideas without leaving the terminal

16 stable releases

2.0.1 Apr 10, 2022
1.8.1 Nov 7, 2020
1.8.0 Aug 8, 2020
1.7.0 Jun 9, 2020
1.0.0 Dec 2, 2017

#796 in Command line utilities

40 downloads per month

MIT license

960 lines

eureka Crate Status CI codecov

eureka is a CLI tool that allows you to quickly write down an idea using your preferred editor, and then have the idea committed and pushed to your idea git repository.

Imagine working on something important and then having an idea. Instead of letting your idea slip by you can just type eureka and you're able to quickly store your idea and then continue working.


Required Setup

eureka requires a git repository with a README.md in the root folder. This is the default structure when you create an empty repository with a readme on GitHub, so it's easy to start using it. And since it's your own repository you can make it private to keep your ideas secret.

eureka looks at your environment variables to decide what program to use.

  • $EDITOR for what to edit your ideas with (falls back to vi)
  • $PAGER for what to view your ideas with (falls back to less)



$ brew install eureka


$ cargo install eureka

Rust stable version will always be supported


The first time you run eureka it will ask for the path to your ideas repo. This configuration will be stored in your XDG Base Directory if found, otherwise in $HOME/.config/eureka.

After the setup simply run eureka to capture an idea. It will then be committed and pushed to the origin remote and the main branch.

View your stored ideas with the -v or --view flag.

$ eureka --view


    --clear-config    Clear your stored configuration
-v, --view            View ideas with your $PAGER env variable. If unset use less

An easy to remember alias for eureka is the word idea. This makes it easy to remember to use eureka to store your ideas.


echo 'alias idea="eureka"' >> ~/.zshrc


echo 'alias idea="eureka"' >> ~/.bashrc


See github issues.


~370K SLoC