qa-find-bugs-cli

Hunt bugs in the bea CLI by running real commands against isolated synthetic ledgers.

275|32|Updated Oct 2, 2020
One-click install
npx skills add https://github.com/bex-co/beancount-io --skill qa-find-bugs-cli-bex-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-find-bugs-cli
Source: https://github.com/bex-co/beancount-io/tree/main/.agents/skills/qa-find-bugs-cli
Command: npx skills add https://github.com/bex-co/beancount-io --skill qa-find-bugs-cli-bex-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually testing a command-line accounting tool across every journey—directives, imports, reports, cloud sync—is slow and error-prone, and bugs often hide in edge cases like paths with spaces, partial batch writes, or JSON output inconsistencies. This Skill automates a disciplined CLI bug hunt that exercises the real executable, reproduces failures, and traces root causes. ## Core Features & Use Cases - Isolated test environments: Runs the bea CLI in subprocesses with dedicated config/cache directories and synthetic ledgers, never touching your real files, credentials, or shell state. - Full journey coverage: Sweeps discovery, directives, batch import, check/format, list/query, reports, automation/JSON output, cloud, and ask/upgrade journeys against documented behavior contracts. - Reproduce and trace: Repeats candidate bugs from pristine fixtures, distinguishes documented behavior from real defects, and traces root causes through the CLI source before filing deduplicated findings. - Use Case: Ask the agent to QA the reports journey on an installed bea binary; it builds fixed-date synthetic fixtures, compares output against independent BQL calculations, reproduces any discrepancy on the checkout, and reports findings by severity. ## Quick Start Use the qa-find-bugs-cli skill to hunt bugs in the bea CLI's reports and directives journeys using synthetic ledgers.

Frequently Asked Questions about qa-find-bugs-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I QA test a CLI tool without affecting my real data?

Run the CLI in subprocesses with isolated BEA_CONFIG_DIR and XDG_CACHE_HOME paths pointing to a temporary run directory, and use synthetic ledger fixtures with fixed dates. Remove inherited environment variables like BEA_FILE and BEA_TOKEN from child processes so your real files and credentials stay untouched.

How do I test CLI commands that require interactive input?

Use a PTY (pseudo-terminal) for genuinely interactive journeys such as device login flows, and close stdin with bounded timeouts for unattended cases. Compare terminal, redirected stdin, --no-input, and CI modes to confirm commands never hang waiting for prompts.

Does this skill test cloud and authenticated CLI features?

Yes, but only with a user-designated QA token or the CLI's real device login flow inside the isolated configuration directory. Without credentials, it continues local and signed-out cases and marks authenticated cloud and live Ask journeys as unverified.

Why might a nonzero exit code not indicate a CLI bug?

Documented behavior allows nonzero exits for partial batch writes, recursive formatting failures, or successful remote creation followed by clone failure. The skill checks the documented exit-code table and JSON exceptions before classifying any behavior as a defect.

What are the limitations of automated CLI bug hunting?

Coverage is limited without a PTY for interactive flows, without QA credentials for cloud journeys, and mock HTTP failures only prove local error handling rather than server defects. The skill reports these gaps explicitly instead of claiming full coverage.