{"id":15377488,"url":"https://github.com/mislav/coral","last_synced_at":"2025-06-26T08:03:20.460Z","repository":{"id":489934,"uuid":"116181","full_name":"mislav/coral","owner":"mislav","description":"Hacker's toolbelt for Ruby, gems, Bundler, git, and more","archived":false,"fork":false,"pushed_at":"2014-01-31T01:52:02.000Z","size":407,"stargazers_count":108,"open_issues_count":0,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-22T01:45:57.822Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://mislav.uniqpath.com/coral/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mislav.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-01-28T00:05:12.000Z","updated_at":"2024-02-05T21:14:51.000Z","dependencies_parsed_at":"2022-07-07T16:37:42.814Z","dependency_job_id":null,"html_url":"https://github.com/mislav/coral","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mislav/coral","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mislav%2Fcoral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mislav%2Fcoral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mislav%2Fcoral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mislav%2Fcoral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mislav","download_url":"https://codeload.github.com/mislav/coral/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mislav%2Fcoral/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262026905,"owners_count":23246951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T14:11:59.303Z","updated_at":"2025-06-26T08:03:20.444Z","avatar_url":"https://github.com/mislav.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Coral\n=====\n\nCoral is a set of shell commands that help working with open-source projects,\nRuby apps, GitHub and more.\n\nCoral is a [sub][] in the way its structure grew out of rbenv's.\n\nInstallation\n------------\n\n~~~ sh\ngit clone git://github.com/mislav/coral.git ~/.coral\n\n# display instructions how to edit shell configuration:\n~/.coral/bin/coral init\n\n# later, when you've reloaded the new shell configuration:\ncoral doctor\n~~~\n\nSee `coral help` for available commands.\n\n\nFeatures\n--------\n\n### Organizing git clones of GitHub repos\n\nIf you read the code or contribute to a number of open-source projects, you\nmight have become tired of picking a clone destination for each of those\nprojects.\n\nCoral can clone repos for you and keep them organized in its internal directory\nstructure:\n\n~~~ sh\ncoral clone bootstrap             # will search GitHub and pick the first result\ncoral clone twitter/bootstrap     # if you want to be explicit\ncoral path bootstrap              # display the path of where Bootstrap is locally\n\ncoral cd bootstrap                # cd into Bootstrap's project directory\ngit tag | coral sort-versions     # display available versions\n\ncoral checkout bootstrap v2.2.0   # check out a new working copy for Bootstrap v2.2.0\ncoral cd bootstrap@v2.2.0         # cd into the new working copy\n\ncoral list bootstrap              # list available working copies of Bootstrap\n~~~\n\n### Working with RubyGems and Bundler\n\nThe bonus of all Coral gem commands are that they are Bundler-aware; i.e. when\nyou give them a name of the gem, they first search for it in the current bundle\nand then in globally installed gems. This helps you with inspecting versions of\ngems that your project currently uses.\n\n~~~ sh\ncoral gem-dir activesupport       # print the root directory of a gem\ncoral gem-open activesupport      # open gem's source code in the editor\ncoral gem-browse sinatra          # open Sinatra's home page in the browser\ncoral gem-browse-project sinatra  # open Sinatra's project page on Github\n\ncoral bundle-ack -w redirect_to   # search across all gems in the bundle\n~~~\n\n### Render documentation files to HTML\n\n~~~ sh\n# render any markup the same way GitHub.com does HTML:\ncoral github-markup path/to/README.md \u003e\u003e readme.html\n\n# `github-markup` output + styles \u0026 syntax highlighting; pipe to browser\ncoral render-markup path/to/README.md | bcat\n~~~\n\n### Opening source code in editor\n\nHandy shortcuts for opening a project's directory in your favorite text editor.\nThe `gem-open` command also has a nice feature for preloading the README file\nfor you, if it exists:\n\n~~~ sh\ncoral gem-open activesupport      # open gem's source code \u0026 README in the editor\ncoral open-dir path/to/project    # open a project in $EDITOR\n~~~\n\nYou should have your shell configured like so:\n\n* Vim:\n\n        EDITOR=vim\n        GEM_EDITOR=mvim   # or \"gvim\" on Linux\n\n* Sublime Text 2:\n\n        EDITOR='subl -w'\n        GEM_EDITOR=subl\n\n* TextMate:\n\n        EDITOR='mate -w'\n        GEM_EDITOR=mate\n\n### Miscellaneous unix goodies\n\n~~~ sh\ncoral sort-versions               # sort version numbers on STDIN\ncoral fetch-url \u003curl\u003e             # fetch URL and cache the result for 24 hours\ncoral parse-json                  # parse JSON and output in flat, line-based format\n~~~\n\n\n  [sub]: https://github.com/37signals/sub\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmislav%2Fcoral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmislav%2Fcoral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmislav%2Fcoral/lists"}