No description
Find a file
2026-03-11 13:20:31 +10:00
general-scripts Use lazygit instead of bash if available 2026-03-11 12:57:24 +10:00
work-scripts Keep work scripts directory but ignore anything added to it 2026-03-11 13:18:08 +10:00
.gitignore Keep work scripts directory but ignore anything added to it 2026-03-11 13:18:08 +10:00
asd Move location of config dir 2026-03-11 12:45:11 +10:00
config.sample LDAP variables 2026-02-10 13:53:45 +10:00
README.md Conventions 2026-03-11 13:20:31 +10:00

Requires bash installed, but can run in any shell theoretically if you don't run this in bash you can get fucked.

I basically restarted this project so that I can run 'asd work' every morning lmao

How to Use

Clone the repository. I like to clone to ~/Projects/repobase/j/asd per convention.

If you don't install it to the above dir by convention, and set ASD_INSTALL_DIR in bashrc.

Then add the path to your PATH; append to ~/.bashrc:

PATH="$PATH:${HOME}/Projects/repobase/j/asd"

Resource your shell with . ~/.bashrc and you should be able to run asd.

Quickly create the configuration file with asd utils gen-conf.

Finally, update your configuration at ~/.config/asd/config.

Script Directories

There are two expected directories with scripts:

$ASD_INSTALL_DIR/general-scripts
$ASD_INSTALL_DIR/work-scripts

Work scripts will not be commited to git. General scripts will. Work scripts is where you store your work-sensitive scripts, general is where you put stuff that wont give your secops team a fucking heart attack.

Conventions

I expect that you keep a clean directory structure:

${HOME}/Projects/<git provider name>/<owner name>/<repo name>

I did originally create this while working with Gitlab primarily though. So it also supports:

${HOME}/Projects/<git provider name>/<group>/[<sub group>/]+/<repo>

That is to say, the following examples are what I expect:

${HOME}/Projects/repobase/j/asd
${HOME}/Projects/github/j/asd
${HOME}/Projects/gitlab/j/scripts/bash/asd