Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/simeg/eureka

💡 CLI tool to input and store your ideas without leaving the terminal
https://github.com/simeg/eureka

cli command-line idea ideas productivity rust terminal

Last synced: 4 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/simeg/eureka
Owner: simeg
License: mit
Created: 2017-11-20T19:45:20.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2023-11-04T06:12:54.000Z (almost 1 year ago)
Last Synced: 2024-04-11T14:24:53.076Z (7 months ago)
Topics: cli, command-line, idea, ideas, productivity, rust, terminal
Language: Rust
Homepage:
Size: 8.43 MB
Stars: 732
Watchers: 8
Forks: 47
Open Issues: 8
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-cli-apps - eureka - Input and store your ideas. (Productivity / Note Taking and Lists)
awesome-list - eureka
fucking-awesome-cli-apps - eureka - Input and store your ideas. (Productivity / Note Taking and Lists)
jimsghstars - simeg/eureka - 💡 CLI tool to input and store your ideas without leaving the terminal (Rust)

README

# eureka [![Crate Status](https://img.shields.io/crates/v/eureka.svg)](https://crates.io/crates/eureka) ![CI](https://github.com/simeg/eureka/workflows/CI/badge.svg) [![codecov](https://codecov.io/gh/simeg/eureka/branch/master/graph/badge.svg)](https://codecov.io/gh/simeg/eureka)
`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.

![demo](assets/demo.gif)

## 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`)

## Installation

**[Homebrew](https://brew.sh/)**
```sh
$ brew install eureka
```

**[Cargo](https://doc.rust-lang.org/cargo)**
```sh
$ cargo install eureka
```

_Rust stable version will always be supported_

## Usage
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](https://wiki.archlinux.org/title/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.

```sh
$ eureka --view
```

### Flags

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

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

**Zsh**
```sh
echo 'alias idea="eureka"' >> ~/.zshrc
```

**Bash**
```sh
echo 'alias idea="eureka"' >> ~/.bashrc
```

**Fish**
```sh
echo 'alias idea="eureka"' >> ~/.config/fish/config.fish
```

## Improvements
See [github issues](https://github.com/simeg/eureka/issues).