A CLI for managing starred Git repositories
If you have a working Go installation, you can:
$ 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. 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
........................................
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
C6C1
'
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)The Limo commands take the form:
$ limo [flags] <verb> <noun> [arguments...]For example, to list your starred repositories for GitHub in plaintext format, you type:
$ limo --service github --output text list starsSome verbs don't require nouns, and flags can go before or after the verb-noun-arguments clause.
| Flag | Description |
|---|---|
-l, --language <language> |
The computer language |
-o, --output <color/text/csv/json> |
The output format |
-s, --service <github/gitlab/bitbucket> |
The service |
-t, --tag <name> |
The tag name |
-u, --user <user> |
The user |
-v, --verbose |
Turn on verbose output |
add
delete [rm]
help
list [ls]
login
open
prune
rename [mv]
show
search [find, q]
tag
untag
update
version
star, stars
tag, tags
trending
| Command | Description |
|---|---|
add star <URL> [tag]... |
Star repository at URL and optionally add tags |
add tag <tag> |
Add tag tag |
delete star <URL/name> |
Unstar repository at URL or name |
delete tag <tag> |
Delete tag tag |
help [command] |
Show help for command or leave blank for all commands |
list languages |
List languages |
list stars [--tag <tag>]... [--language <language>]... [--service <service>]... [--user <user>] [--output <output>] |
List starred repositories |
list tags [--output <output>] |
List tags |
list trending [--language <language>]... [--service <service>]... [--output output] |
List trending repositories |
login [--service <service>] |
Logs in to a service (default: github) |
open <star> |
Opens the URL of a star in your default browser |
prune [--dryrun] |
Prunes unstarred items from your local database |
rename <tag> <new> |
Rename tag tag to new |
show <star> [--output <output>] |
Show repository details |
search <search string> [--output <output>] |
Search your stars |
tag <star> <tag>... |
Tag starred repository star using tags tag |
untag <star> <tag>... |
Untag starred repository star using tag or leave blank for all tags |
update [--service <service>] [--user <user>] |
Update service or leave blank for all services for user user or leave blank for you |
version |
Show program version |
Limo uses the following open source libraries -- thank you!
Apologies if I've inadvertently omitted any.
- 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 findlimo.yaml, which contains your GitHub API Key (so guard it!) and the path to your SQLite database, which defaults to the same directory.
- The configuration is stored in
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 installCopyright © 2016 Rob Warner
Licensed under the MIT License