Skip to content

arvis-workflows/arvis-tldr-workflow

Repository files navigation

arvis-tldr-workflow

arvis workflow for TLDR docs

Screenshot

Install

The workflow can be installed as a global NPM dependency. This makes it really easy to keep things up to date, since you can just upgrade to the latest version through NPM.

npm install --global arvis-tldr-workflow

However, if you don't like global NPM packages, you can always clone the repo and install the dependencies; that will set up the workflow as well. The downside is that you'll need to keep the repo updated to the latest version manually, and install the dependencies again after each update.

git clone https://github.com/alexlafroscia/tldr-arvis.git
cd tldr-arvis
yarn install # Or `npm install` if you don't have yarn

Usage

In arvis, type tldr followed by the name of a command you want to search for, such as man.

Continue typing to filter the results by the contents of the code example.

More Features

  • Pressing CMD-C on a result will copy the code example to the keyboard
  • Pressing CMD-L on any of the results will show the full Markdown description of the command
  • Pressing CMD-Y on any of the results will show the TLDR webpage for the command in the Quicklook window

Authenticating

If you want to (especially if you're running into rate limiting issues) you can provide your Github username and personal API token to authenticate your requests. with the former being your Github username and the latter being a personal access token that you can generate here.

FAQ

Q: I'm getting an error about rate limiting? What's going on?

I noticed during development that after hitting their API repeatedly, Github started sending 403 responses. If you wait a bit, you should be able to make requests again. Alternatively, try setting a username/password as detailed above.

License

MIT © Alex LaFroscia

🔗 This workflow is converted from alfred-workflow.

  • Note that there might be some code change or different actions from the original workflow.

  • Marked original workflow's creator to author.