gws-vault

googleworkspace/cli · updated Apr 8, 2026

$npx skills add https://github.com/googleworkspace/cli --skill gws-vault
0 commentsdiscussion
summary

Google Vault eDiscovery management for holds, exports, and matter lifecycle operations.

  • Manage matters (create, list, update, close, delete, reopen) with permission controls for collaborators
  • Execute holds and exports on matters, plus manage saved queries for repeated eDiscovery searches
  • Monitor long-running operations with get, list, and cancel methods for asynchronous job tracking
  • Requires Google Workspace authentication via shared gws CLI; use gws schema to inspect method param
skill.md

vault (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws vault <resource> <method> [flags]

API Resources

matters

  • addPermissions — Adds an account as a matter collaborator.
  • close — Closes the specified matter. Returns the matter with updated state.
  • count — Counts the accounts processed by the specified query.
  • create — Creates a matter with the given name and description. The initial state is open, and the owner is the method caller. Returns the created matter with default view.
  • delete — Deletes the specified matter. Returns the matter with updated state.
  • get — Gets the specified matter.
  • list — Lists matters the requestor has access to.
  • removePermissions — Removes an account as a matter collaborator.
  • reopen — Reopens the specified matter. Returns the matter with updated state.
  • undelete — Undeletes the specified matter. Returns the matter with updated state.
  • update — Updates the specified matter. This updates only the name and description of the matter, identified by matter ID. Changes to any other fields are ignored. Returns the default view of the matter.
  • exports — Operations on the 'exports' resource
  • holds — Operations on the 'holds' resource
  • savedQueries — Operations on the 'savedQueries' resource

operations

  • cancel — Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation.
  • delete — Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
  • get — Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
  • list — Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws vault --help

# Inspect a method's required params, types, and defaults
gws schema vault.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.659 reviews
  • Diego Gupta· Dec 28, 2024

    gws-vault fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Anika Park· Dec 24, 2024

    Useful defaults in gws-vault — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Hana Perez· Dec 24, 2024

    Solid pick for teams standardizing on skills: gws-vault is focused, and the summary matches what you get after install.

  • Anaya Martinez· Dec 20, 2024

    Registry listing for gws-vault matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Camila Kapoor· Dec 16, 2024

    Keeps context tight: gws-vault is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Henry Harris· Dec 8, 2024

    gws-vault is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Charlotte Mehta· Nov 27, 2024

    Solid pick for teams standardizing on skills: gws-vault is focused, and the summary matches what you get after install.

  • Carlos Park· Nov 19, 2024

    We added gws-vault from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Anaya Thompson· Nov 15, 2024

    I recommend gws-vault for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Diego Iyer· Nov 15, 2024

    gws-vault is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

showing 1-10 of 59

1 / 6