vibecheck-error-assistant-cli 0.1.0

Run commands and translate programming errors into beginner-friendly explanations

VibeCheck CLI

VibeCheck runs your command, catches failures, and translates technical stderr into beginner-friendly guidance.

Install (MVP)

From project root:

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

After install, you can use the vibecheck command directly.

Configure

cp .env.example .env
# edit .env and set VIBECHECK_GITHUB_TOKEN

Usage

Single command mode:

vibecheck python buggy_sample.py

Interactive mode (tool waits in terminal):

vibecheck --shell

Then type commands like:

python buggy_sample.py
node buggy_advanced.js

Exit interactive mode with exit or quit.

Useful Flags

vibecheck --level beginner python buggy_sample.py
vibecheck --level advanced node buggy_advanced.js
vibecheck --print-raw-error python buggy_sample.py

Exit Codes

• Returns 0 when wrapped command succeeds.
• Returns wrapped command's non-zero exit code when command fails.
• Returns 2 on configuration errors.