This repository has been archived on 2023-01-14. You can view files and clone it, but cannot push or open issues or pull requests.
toolkit/README.md
2022-12-19 10:11:05 +01:00

62 lines
1.6 KiB
Markdown

# Toolkit
This is an opinionated toolkit, which reflect my (@kjuulh) way of working. This
project aims to enhance a general workflow, and provides tools that may be
useful outside of project work. For project work see repo:kjuulh/bust or
repo:kjuulh/char, which aims for the same thing, but for projects themselves.
## Install
Currenly I only publish homebrew packages, however, all artifacts are released
via. released, that includes deb packages as well.
### Homebrew
```
brew install kjuulh/brew/toolkit
```
## Configuration
To use toolkit you will need a series of environment variables, they are only
needed if you need the associated tool.
```
export SRC_ENDPOINT=https://sourcegraph.com
export SRC_ACCESS_TOKEN=
export GITHUB_FC_ROOT="/Users/<username>/git/github.com"
export GITHUB_FC_ORGS="kjuulh"
```
`SRC` is sourcegraph integration. The endpoint is either to the public instance,
or your own domain. The access token is a personal access token. If either of
these are missing. A prompt will be shown on the first run
`GITHUB_FC` is the fuzzy clone setup. First is the destination path, this is
where the orgs will be placed. Second is ORGS, that is which orgs to subscribe
to. The total path in this case will end up being
`/Users/<username>/git/github.com/kjuulh`.
You will also require other integration such as a GitHub integration through
`gh`.
## Usage
```
Usage: toolkit <COMMAND>
Commands:
prereqs
tldr
sourcegraph
github
stats
init
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help information
```
![demo](assets/demo.gif)