API request runner for `.http` and `.rest` files across HTTP, GraphQL, gRPC, WebSocket, MQTT, and OAuth2 workflows.
$npm install -g httpyac
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
httpyac is a request runner for .http and .rest files, aimed at API workflows that are easier to keep in text than in a GUI client. It can execute single requests or whole collections across HTTP and several adjacent protocols.
What It Enables
- Run named, tagged, line-selected, or whole-file request suites from checked-in
.httpand.restfiles. - Apply environments, inline variables, dotenv-backed config, and OAuth2 token generation to repeatable API calls across HTTP, GraphQL, gRPC, WebSocket, MQTT, and related protocols.
- Execute assertions and export JSON or JUnit results for CI checks, regression tests, or agent follow-up steps.
Agent Fit
--jsongives structured per-request summaries, responses, timestamps, durations, and test results that are straightforward to parse in shell loops.- Non-interactive usage is solid when you pass files plus
--all,--name,--line, or--tag; otherwisesendfalls back to an interactive selector. - Best fit for repo-backed API workflows where request definitions live beside code and need inspect, change, and verify cycles.
Caveats
- If you do not specify which request to run, the default selection path prompts through
inquirer, which is awkward for unattended runs. - Most of the value assumes you maintain request files and environment data in the project rather than issuing one-off ad hoc commands.