A CLI for managing starred Git repositories
Both GitHub and GitLab allow you to "star" repositories, and Bitbucket lets you "watch" them. "Starring" or "watching" lets you keep track of repositories you find interesting, but none of the services provide ways to search or tag your repositories so you can easily find them.
Limo lets you manage your starred repositories from the command line. You can do things like tag them, search them, or list them by language. Think of Limo as the CLI version of Astral (also worth looking into).
If you have a working Go installation, type:
$ go get -u github.com/hoop33/limoBinaries for the various platforms not yet available.
Limo is currently under development, and some things may change. Not all of it is implemented yet. Right now, GitHub is the only service supported.
You can read the full usage documentation at https://www.gitbook.com/book/hoop33/limo/details.
Here's how to get started:
First, create an API key for your GitHub account, and then type:
$ limo login
Enter your GitHub API token:$ limo update
Updating . . . /
Created: 10; Updated: 46; Errors: 0$ limo list languages
...
Go
...
VimL$ limo list stars
...
jaxbot/github-issues.vim (VimL)
jaxbot/semantic-highlight.vim (VimL)
...$ limo list stars -l viml
...
jaxbot/github-issues.vim (VimL)
jaxbot/semantic-highlight.vim (VimL)
...$ limo tag jaxbot vim github
Star 'jaxbot' ambiguous:
jaxbot/github-issues.vim (★ : 344) (VimL)
jaxbot/semantic-highlight.vim (★ : 204) (VimL)
Narrow your search$ limo tag github-issues vim github
jaxbot/github-issues.vim (★ : 344) (VimL)
Added tag 'vim'
Added tag 'github'$ limo show github-issues
jaxbot/github-issues.vim (★ : 344) (VimL)
vim, github
Github issue lookup in Vim
Home page: http://jaxbot.me/articles/github-issues-vim-plugin-5-7-2014
URL: https://github.com/jaxbot/github-issues.vim.git
Starred at Fri Feb 21 16:02:49 UTC 2014$ limo list tags
cli
git
vim
web$ limo list stars -t vim
vim/vim (★ : 4979) (C)
tybenz/vimdeck (★ : 946) (Ruby)
jaxbot/github-issues.vim (★ : 344) (VimL)$ limo search text editor
(0.703194) limetext/lime (★ : 12522)
(0.613690) driusan/de (★ : 115) (Go)
(0.608085) Cocoanetics/DTRichTextEditor (★ : 257) (Objective-C)
(0.608085) atom/atom (★ : 28810) (CoffeeScript)
(0.605340) zyedidia/micro (★ : 1973) (Go)
(0.602631) vicoapp/vico (★ : 666) (Objective-C)
(0.597322) xmementoit/vim-ide (★ : 142) (VimL)
(0.597322) textmate/textmate (★ : 10873) (C++)
(0.589614) macvim-dev/macvim (★ : 1820) (C)
(0.294723) yi-editor/yi (★ : 931) (Haskell)You can read the full usage documentation at https://www.gitbook.com/book/hoop33/limo/details.
- Why the name "limo"?
- If you know anything about Hollywood, you know that limos carry . . . stars.
- Where is this information stored?
- The configuration is stored in
~/.config/limo. Inside that directory, you'll find:limo.yaml: Configuration informationlimo.db: The SQLite database that stores all your stars and tagslimo.idx: The Bleve search index
- The configuration is stored in
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See CODE_OF_CONDUCT file.
Contributions are welcome! Please open pull requests with code that passes all the checks. See Building for more information.
You must have a working Go development environment to contribute code. I have tested so far only on Go 1.6.2 on OS X. limo uses a vendor folder, so requires Go 1.6+ or Go 1.5 with GO15VENDOREXPERIMENT=1 (though I haven't tested that).
The included makefile performs various checks on the code. To get started, run:
$ make get-depsThis will install golint and errcheck. You should have to do this only once.
Then, you can run:
$ makeTo run the code checks and tests. To build and install, run:
$ make installLimo uses the following open source libraries -- thank you!
Apologies if I've inadvertently omitted any.
Copyright © 2016 Rob Warner
Licensed under the MIT License