ideaseed 0.4.0

Note down your ideas and get them to the right place, without switching away from your terminal

ideaseed

Do you have ideas suddenly and just wished you could catch them as fast as possible, as to not loose them, without having to interrupt what you were doing?

As I guy without a lot of more or less stupid ideas, I use Google Keep as a centralized place to put all of my thoughts that I deem worthy of consideration.

I recently started to use GitHub Projects for coding project ideas as a single project called "incubator" on my GitHub profile directly, and as issues or notes when the idea is related to an already-existing project and repo.

But when I don't get to decide when this idea comes, and I often need to interrupt what am I doing to open github, get to the right page, input my idea and get back. And I find it frustrating.

Enough rambling. Here's what you came for.

Note down your ideas and get them to the right place, without switching away from your terminal

Installation

Ideaseed is available on PyPI.org:

pip install ideaseed

Usage

ideaseed (--help | --about | --version)
ideaseed [options] ARGUMENTS...

Examples

# Save a card "test" in schoolsyst/webapp > project "UX" > column "To-Do"
$ ideaseed schoolsyst/webapp UX "test"
# Save a card "lorem" in your-username/ipsum > project "ipsum" > column "To-Do"
$ ideaseed ipsum "lorem"
# Save a card "a CLI to note down ideas named ideaseed" in your user profile > project "incubator" > column "willmake"
$ ideaseed --user-keyword=project --user-project=incubator project "a CLI to note down ideas named ideaseed"

Arguments

Argument	Meaning	Default value
REPO	Select a repository by name
	If not given, uses Google Keep instead of GitHub (or uses your user profile's projects if --project is used)
	If --user-keyword's value is given, creates a card on your user's project (select which project with --user-project)
	If given in the form OWNER/REPO, uses the repository OWNER/REPO
	If given in the form REPO, uses the repository "your username/REPO"
PROJECT	Select a project by name to put your card to [default: REPO's value]	REPO's value
	If creating a card on your user's project, this becomes the COLUMN
COLUMN	Select a project's column by name [default: To-Do]	To-Do
	If creating a card on your user's project, this is ignored

Options

Shorthand	Full-length	Description
-c	--color COLOR	Chooses which color to use for Google Keep cards. See Color names for a list of valid values
-t	--tag TAG	Adds tags to the Google Keep card.
-i	--issue TITLE	Creates an issue with title TITLE.
-I	--interactive	Prompts you for the above options when they are not provided.
-L	--logout	Clears the authentification cache
-m	--create-missing	Create non-existant tags, projects or columns specified (needs confirmation if -I is used)
-o	--open	Open the relevant URL in your web browser.
	--about	Details about ideaseed like currently-installed version
	--version	Like --about, without dumb and useless stuff
	--user-project NAME	Name of the project to use as your user project
	--user-keyword NAME	When REPO is NAME, creates a GitHub card on your user profile instead of putting it on REPO
	--no-auth-cache	Don't save credentials in a temporary file

Color names

• blue
• brown
• darkblue
• gray
• green
• orange
• pink
• purple
• red
• teal
• white
• yellow

You don't have to specify the whole color name, just enough to be non-ambiguous:

• bl
• br
• d
• gra
• gre
• o
• pi
• pu
• r
• t
• w
• y

Relax. You don't need to remember those options

You can also use ideaseed -I to prompt you for some information:

• Where do you want to upload this idea? (github, google keep)
• If you decide to use github,
  • On your profile?
  • If not:
    • Which repo? (using REPO or OWNER/REPO) (autocompletes with repositories you contribute to)
    • Which column? (choices are the column names, and you can type the column's index to be quicker)
• If you decide to use google keep,
  • Which color? (defaults to white)
  • Some tags?