ash-scripts

A small, cross-platform toolkit of shell helpers for everyday developer workflows. The first included command, ash, runs supported AI coding CLIs while saving a terminal transcript for later reference.

Supported platforms

• macOS with the bundled BSD script command
• Linux with the util-linux script command
• Bash 3.2 or newer

Install the CLI you want to wrap separately: Claude Code, Codex CLI, or Gemini CLI.

Installation

git clone https://github.com/ashears/ash-scripts.git
cd ash-scripts
./install.sh

The installer creates a symlink at ~/.local/bin/ash. If that directory is not already on your PATH, it prints the exact line to add to your Zsh or Bash configuration. It never edits your shell files or overwrites an unrelated command.

Usage

Run any supported CLI and pass its arguments through normally:

ash claude
ash codex --help
ash gemini --model gemini-2.5-pro

By default, transcripts are written to:

${XDG_STATE_HOME:-$HOME/.local/state}/ash-scripts/logs

Each filename includes the CLI name, timestamp, and process ID. Override the destination when needed:

ASH_LOG_DIR="$HOME/my-logs" ash codex
ASH_LOG_FILE="$HOME/my-logs/review.log" ash claude

Warning

Terminal transcripts can contain source code, prompts, command output, paths, tokens, or other sensitive information. Log files are created with user-only permissions, but you should still review them before sharing.

Run ash --help to list commands.

Uninstall

Remove the installed symlink:

rm "$HOME/.local/bin/ash"

Your cloned repository and saved transcripts are left untouched.

License

Released under the MIT License.