Alpha guide

Install Quackshell Alpha.

The alpha installer only installs the CLI. Skill installation is optional and is managed by the CLI so users can choose a global Codex install or a project-local install.

Install the CLI

curl -fsSL https://quackshell.com/install/alpha.sh | sh
quackshell-cli-alpha --version

Manual CLI install

# macOS: brew install pipx
# Debian/Ubuntu: sudo apt install pipx
pipx ensurepath
pipx install --python python3.12 --force https://quackshell.com/downloads/alpha/quackshell_cli_alpha-0.7-py3-none-any.whl

Configure a token

Use the alpha token you were given. The CLI checks the environment first, then the current directory for quackshell-alpha.key.

export QUACKSHELL_ALPHA_API_TOKEN="..."

cat > quackshell-alpha.key <<'EOF'
QUACKSHELL_ALPHA_API_TOKEN=...
EOF

Install the Codex skill

Global install makes $quackshell-alpha available across projects.

quackshell-cli-alpha install-skill codex --scope user

Local install writes the skill into the current project at ./.codex/skills/quackshell-alpha.

quackshell-cli-alpha install-skill codex --scope local

Use it

quackshell-cli-alpha --port 8000

Uninstall

pipx uninstall quackshell-cli-alpha
quackshell-cli-alpha uninstall-skill codex --scope user
quackshell-cli-alpha uninstall-skill codex --scope local
rm -f quackshell-alpha.key

If you uninstall the CLI first, remove the skill directories directly:

rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/quackshell-alpha"
rm -rf ./.codex/skills/quackshell-alpha