ackchyually

the “ackchyually…” friend for your CLI. Remembers what worked (per repo). Suggests the right command when you get the details wrong.

Agent CLIs (Codex / Claude / Copilot)

ackchyually shim install git gh bd xcodebuild
ackchyually integrate all
ackchyually integrate verify codex

Supported versions: Codex CLI (codex) ≥ 0.0.0 • Claude Code (claude) ≥ 0.0.0 • Copilot CLI (copilot) ≥ 0.0.0

macOS / Linux

curl -fsSL https://ackchyually.sh/install.sh | sh

Windows

Download .zip from Releases

GitHub Releases Discussions

Install Shims

ackchyually shim install git gh bd xcodebuild

Verify

export PATH="$HOME/.local/share/ackchyually/shims:$PATH"
which git
# should be: ~/.local/share/ackchyually/shims/git

Example

If you’ve run a command successfully before in this repo/context, a later “usage-ish” failure triggers a suggestion:

git log -1 --prety=%s
ackchyually: suggestion (previous success in this repo):
  git log -1 --pretty=%s

How it works

Transparent shims: you keep typing git ... normally.
PTY-first: if you're in a TTY, tools run under a real PTY so interactive CLIs behave normally (ConPTY on Windows).
Local memory: logs invocations (redacted) to SQLite, keyed by repo/cwd context.

PTY-first (hard requirement)

If you're in a TTY, ackchyually runs tools under a PTY. This is non-negotiable for interactive CLIs and agent shells (Claude Code / Codex CLI / Copilot CLI).

Security

ackchyually redacts before writing to the local DB and applies stricter redaction on export. Treat your local database as sensitive.