bruno

Run and validate Bruno CLI API tests from bru files with options.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/towry/dots --skill bruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bruno
Source: https://github.com/towry/dots/tree/main/conf/claude-local-marketplace/skills/bruno
Command: npx skills add https://github.com/towry/dots --skill bruno

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you automate API testing by using Bruno, a Postman-like CLI, to run, organize, and verify API requests locally.

Core Features & Use Cases

  • Bruno CLI Navigation: Locate Bruno collections and environment data, e.g., discovering the <bruno-collection-dir> that contains bruno.json.
  • Test Execution & Reporting: Run tests via Bruno, manage collections, environments, and generate results for integration in CI or reports.
  • Portable Workflows: Execute deterministic API tests in local environments and share results with teammates.

Quick Start

From your project root, locate the Bruno collection directory (the one containing bruno.json) and run a Bruno command, for example: bruno run --env development <bruno-collection-dir>/bruno.json

Frequently Asked Questions about bruno

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

FAQPage Schema
How do I automate API testing with Bruno CLI?

Automate API testing by running Bruno CLI commands against your collection directory. Locate the folder containing bruno.json, then execute `bruno run --env environment-name <collection-dir>` to execute all defined API requests and validations in your bru files locally.

Can I run Bruno API tests in parallel and generate reports?

Yes, Bruno CLI supports parallel test execution with the `--parallel` flag and multiple reporter formats for CI integration. Combine options like `--delay`, `--iteration-count`, and reporter flags to customize test runs and export results for downstream analysis.

What file structure does Bruno use for organizing API collections?

Bruno organizes API tests in collections under a root directory containing bruno.json. Each API request is defined in a bru file with sections for meta, request details, settings, and test assertions, allowing you to structure requests in folders and manage environments separately.

How do I manage environments and variables in Bruno API tests?

Bruno CLI accepts environment configuration via `--env-file` or `--env` flags to inject variables and credentials into your API requests. Store environment data alongside your collection and reference it when running tests to keep configurations portable and secure.

Can I run specific tests or tags with Bruno instead of the entire collection?

Yes, use the `--tests-only` flag to run only test validations without executing requests, or filter by tags to execute specific subsets of your API collection. This enables targeted testing in CI pipelines and faster feedback loops.