Copilot tools

When the extension is installed, GitHub Copilot Chat’s agent mode can use Vegha’s tools directly. Open Chat, switch to Agent, and ask for what you want:

Add a request that creates an order in the orders-api collection, with a test that the status is 201, and run it against staging.

Copilot picks the tools it needs. To point it at one, type # and the tool’s reference name, such as #veghaSend or #veghaRequest. You can also turn tools on or off in the chat’s tools picker.

Tools

Discover

Tool	Reference	What it does
List Vegha collections	#veghaCollections	Lists the collections in the workspace with their folders and requests.
Search Vegha requests	#veghaSearch	Finds requests by name, URL or method across all collections.
Get a Vegha request	#veghaRequest	Returns a request as JSON: method, URL, params, headers, body, auth, scripts and more.
List Vegha environments	#veghaEnvironments	Lists a collection’s environments, which one is active, and their variables (secrets redacted).

Change requests

Tool	Reference	What it does
Create a Vegha request	#veghaCreateRequest	Creates a new .bru request in a collection folder.
Update a Vegha request	#veghaUpdateRequest	Changes only the fields it’s given (a JSON merge patch over the request).
Set request scripts	#veghaSetScripts	Sets pre-request, post-response and test JavaScript.
Set request assertions	#veghaSetAssertions	Sets scriptless assertions such as res.status eq 200.
Set response captures	#veghaSetCaptures	Captures response values into runtime, environment or workspace variables.
Set linked requests	#veghaSetChain	Sets the requests that run first, such as a login, and when they run.
Create a Vegha folder	#veghaCreateFolder	Creates a folder to group requests.
Import a cURL command	#veghaImportCurl	Creates a request from a cURL command.
Delete a Vegha request	#veghaDeleteRequest	Deletes a request file. You’re always asked to confirm.

Run

Tool	Reference	What it does
Activate a Vegha environment	#veghaUseEnvironment	Chooses the environment {{variables}} resolve from.
Set a variable	#veghaSetVariable	Sets a variable for this session only. Nothing is written to disk.
Send a Vegha request	#veghaSend	Sends a request exactly as Send does and returns status, timing, test results, variables set, headers and the start of the body.
Run a Vegha folder or collection	#veghaRun	Runs every request in order, carrying variables, and returns a pass/fail summary.

Look up

Tool	Reference	What it does
Get a request’s last response	#veghaLastResponse	Returns the last response from this session, or one value from it such as res.body.items[0].id.
Generate code for a request	#veghaCode	Generates a code snippet for the request, including inherited headers and auth.
Vegha request history	#veghaHistory	Lists recent sends from the shared history.
Vegha scripting reference	#veghaScriptReference	Returns the scripting and assertion reference, so the model writes valid tests.

Approvals

Changes to a request show their .bru diff for approval and are applied as undoable edits. Sends show the target URL first. See Overview & safety.