Shell Integration

The shell hook is optional. Without it, aisw use still writes live tool credential files and updates ~/.aisw/config.json. The hook adds one capability: applying the emitted environment variable exports (CLAUDE_CONFIG_DIR, CODEX_HOME) into the current shell session.

Install

Zsh

Add to ~/.zshrc:

eval "$(aisw shell-hook zsh)"

Then reload:

source ~/.zshrc

Bash

Add to ~/.bashrc (interactive shells) or ~/.bash_profile:

eval "$(aisw shell-hook bash)"

Then reload:

source ~/.bashrc

Fish

Add to ~/.config/fish/config.fish:

aisw shell-hook fish | source

Or as a standalone file:

aisw shell-hook fish > ~/.config/fish/conf.d/aisw.fish

Verify

echo "$AISW_SHELL_HOOK"
# Expected: 1

What the hook does

The hook wraps the aisw function in your shell. When you run aisw use ..., the hook:

1. Runs aisw use ... --emit-env to write the credential files and print export VAR=value lines to stdout.
2. Evals those exports in the current shell, so CLAUDE_CONFIG_DIR and CODEX_HOME are set immediately.
3. Passes all other aisw subcommands through to the binary unchanged.

Without the hook, you can achieve the same effect manually:

eval "$(aisw use claude work --emit-env)"

Remove

Remove the eval line from your shell config and open a new shell.

To remove hook blocks that aisw init or aisw shell-hook added:

aisw uninstall --dry-run    # preview
aisw uninstall --yes        # apply

Shell completions

aisw ships completion scripts for bash, zsh, and fish. They are installed automatically by the Homebrew formula and shell installer.

Installed locations

Shell	Path
bash	~/.local/share/bash-completion/completions/aisw
zsh	Writable fpath entry, or ~/.zsh/completions/_aisw
fish	~/.config/fish/completions/aisw.fish

Manual install from source

cargo build --release

install -Dm644 completions/aisw.bash \
  ~/.local/share/bash-completion/completions/aisw

install -Dm644 completions/_aisw \
  ~/.zsh/completions/_aisw

install -Dm644 completions/aisw.fish \
  ~/.config/fish/completions/aisw.fish

For zsh, ensure the completion directory is in your fpath:

fpath=(~/.zsh/completions $fpath)
autoload -U compinit && compinit