Give it a clear brief.
Choose a task, a success check, and the access the agent needs. Define the harness, model, and environment.
Make agent experience part of product design.
A usability toolkit for the interfaces agents actually use: your CLI, docs, SDK, and API. Inspect the journey and turn friction into a better design.
Observe discoverability and the gap between documented and actual behavior.
Make the quick-start export command executable.
Observe error messages, non-interactive operation, and structured output.
Make the next action clear when a command fails.
Observe installation, API discovery, version assumptions, and examples.
Show a minimal working path through the public API.
Observe authentication guidance, errors, and machine-readable outcomes.
Make success and failure independently verifiable.
The workflow
Start with a single task. Grow into a matrix of harnesses and models once you know what you want to learn.
Choose a task, a success check, and the access the agent needs. Define the harness, model, and environment.
A new worker tries the product. AJX records its actions and keeps the artifacts available in the local console.
Inspect verification and the visual journey. Follow each ask back to events before deciding what to change.
Try the output first
Switch between the fictional runs. Compare their asks and verified outcomes, then open the underlying evidence.
The documented --out flag fails. Command help reveals --output, which works.
The export completes, but the agent still cannot tell whether it is working while it runs.
The export requires approval that the unattended worker cannot provide. The task does not finish.
Your first attempt
Open your project in a skill-capable agent and paste this prompt. It installs the native CLI and matching skill, checks setup, and helps you plan a small first run.
Use macOS or Linux, with a supported worker CLI installed and signed in.
Agree on the task, success check, access, and expected model costs.
Open the report and visual journey. Inspect the first product ask and decide what to improve.
Ready to repeat it? Add matrix runs or ajx ci acceptance checks to your
pipeline.
Install the latest stable AJX CLI and skill by following https://raw.githubusercontent.com/royosherove/ajx/main/docs/AGENT-QUICKSTART.md Then load the installed AJX skill. I want to use AJX to test jq. Starting point: https://jqlang.org/manual/ Task: Filter a sample JSON inventory to in-stock items and export their names and prices as CSV. Prepare any tools, generated sample data, and local test server needed in a temporary workspace. Use the AJX skill to run one trial with a fresh agent, verify the result, and show me the report and journey.
bash -o pipefail -c 'curl -fsSL https://github.com/royosherove/ajx/releases/latest/download/install.sh | bash' && export PATH="$HOME/.local/bin:$PATH"
macOS or Linux. The installer includes the skill. Your agent can read it directly; start a fresh session if the host needs one to discover /ajx. No GitHub login required.
The Go CLI and Agent Skill install together.
No Go toolchain or GitHub login
needed.