Rewst

Rewst Claude Code Skill

Prerequisites: Install the CLI

This skill drives the rewst-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. macOS / Linux:

   bash <(curl -fsSL https://raw.githubusercontent.com/servosity/msp-skills/main/skills/rewst/install.sh)
   

2. Windows (PowerShell):

   iwr -useb https://raw.githubusercontent.com/servosity/msp-skills/main/skills/rewst/install.ps1 | iex
   

3. Verify: rewst-cli --version
4. Ensure ~/.local/bin (macOS / Linux) or %LOCALAPPDATA%\Programs\msp-skills (Windows) is on $PATH.

If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

Rewst's only surface is a GraphQL gateway with no first-party CLI and no local state. This CLI mirrors organizations, workflows, executions, variables, packs, triggers, forms, and the rest as typed commands with --json/--select/--agent output, an api command for full schema coverage, and offline SQLite sync. On top of that it adds multi-org rollups - fleet execution health, failure triage, automation ROI, dormant-workflow detection, cross-org config drift, and pack coverage - that an MSP operator otherwise has to assemble by clicking through the web app one client at a time.

When to Use This CLI

Use this CLI to operate and monitor Rewst from the terminal or an agent: check whether automation is healthy for a client, triage failed runs, report how much time automation saved, find dormant workflows, compare configuration between tenants, and read or run any Rewst entity. It is the right tool when you want scriptable, JSON-first access to Rewst across many client organizations rather than clicking through the web console one org at a time.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to build or visually edit workflow graphs - author those in the Rewst workflow designer.
• Do not use it as a long-running event listener or webhook receiver; for inbound triggers configure a Rewst trigger or the webhook URL instead.
• Do not use it to administer billing or the Rewst account itself; that lives in the Rewst console.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Fleet monitoring that compounds

• health - One-call workflow execution health for an org: succeeded / failed / running / pending counts plus time saved, with a clear unhealthy verdict when failures are present.

  Reach for this first to answer 'is automation healthy for this client right now' without paging through the web app org by org.

  rewst-cli health --org 11111111-1111-1111-1111-111111111111 --since 24h --agent
  

• failures - Recent failed workflow executions for an org, newest first, with workflow id, status, task counts, and age - the triage queue the API has no single endpoint for.

  Use this when something broke overnight and you need the failed runs to investigate, not every run.

  rewst-cli failures --org 11111111-1111-1111-1111-111111111111 --since 12h --limit 20 --agent
  

• dormant - Workflows that have not executed in N days - dead or orphaned automation that is still installed but no longer running.

  Use this to clean up or re-enable automation that quietly went idle after a trigger or integration broke.

  rewst-cli dormant --org 11111111-1111-1111-1111-111111111111 --days 30 --agent
  

ROI and reporting

• roi - Aggregates Rewst's humanSecondsSaved metric across an org's workflows into total hours/days saved and the top time-saving automations.

  Reach for this to turn automation into a dollar/time story for a QBR or client report.

  rewst-cli roi --org 11111111-1111-1111-1111-111111111111 --since 30d --agent
  

Multi-tenant governance

• drift - Compares org variables and installed packs between two organizations and reports what one has that the other is missing.

  Reach for this when an automation works in one tenant but not another and you suspect a missing variable or uninstalled pack.

  rewst-cli drift --org 11111111-1111-1111-1111-111111111111 --against 22222222-2222-2222-2222-222222222222 --agent
  

• coverage - Across a parent org's managed sub-orgs, shows which integration packs are installed where and flags orgs missing a pack - bounded by a scan cap.

  Use this to confirm an integration is rolled out to every client tenant, or to find the ones it skipped.

  rewst-cli coverage --parent 11111111-1111-1111-1111-111111111111 --pack microsoft --agent
  

Command Reference

action-options - Manage action-options

• rewst-cli action-options create - Create a actionoption
• rewst-cli action-options get - Get a single actionoption

actions - Manage actions

• rewst-cli actions create - Create a action
• rewst-cli actions get - Get a single action

active-conversation-requests - Manage active-conversation-requests

• rewst-cli active-conversation-requests - Get a single activeconversationrequest

affected-workflow-infos - Manage affected-workflow-infos

• rewst-cli affected-workflow-infos - Get a single affectedworkflowinfo

api-client-lists - Manage api-client-lists

• rewst-cli api-client-lists - Get a single apiclientlist

api-clients - Manage api-clients

• rewst-cli api-clients <id> - Get a single apiclient

app-platform-reserved-domains - Manage app-platform-reserved-domains

• rewst-cli app-platform-reserved-domains create - Create a appplatformreserveddomain
• rewst-cli app-platform-reserved-domains get - Get a single appplatformreserveddomain
• rewst-cli app-platform-reserved-domains update - Update a appplatformreserveddomain

commonly-used-actions - Manage commonly-used-actions

• rewst-cli commonly-used-actions - Get a single commonlyusedaction

component-instances - Manage component-instances

• rewst-cli component-instances create - Create a componentinstance
• rewst-cli component-instances get - Get a single componentinstance
• rewst-cli component-instances update - Update a componentinstance

component-trees - Manage component-trees

• rewst-cli component-trees - Get a single componenttree

components - Manage components

• rewst-cli components - Get a single component

conversation-message-votes - Manage conversation-message-votes

• rewst-cli conversation-message-votes create - Create a conversationmessagevote
• rewst-cli conversation-message-votes get - Get a single conversationmessagevote
• rewst-cli conversation-message-votes update - Update a conversationmessagevote

conversation-messages - Manage conversation-messages

• rewst-cli conversation-messages - Create a conversationmessage

conversations - Manage conversations

• rewst-cli conversations create - Create a conversation
• rewst-cli conversations get - Get a single conversation
• rewst-cli conversations update - Update a conversation

crate-override-options - Manage crate-override-options

• rewst-cli crate-override-options create - Create a crateoverrideoption
• rewst-cli crate-override-options update - Update a crateoverrideoption

crate-overrides - Manage crate-overrides

• rewst-cli crate-overrides create - Create a crateoverride
• rewst-cli crate-overrides update - Update a crateoverride

crate-unpacking-argument-sets - Manage crate-unpacking-argument-sets

• rewst-cli crate-unpacking-argument-sets - Get a single crateunpackingargumentset

crate-use-cases - Manage crate-use-cases

• rewst-cli crate-use-cases - Get a single crateusecase

crates - Manage crates

• rewst-cli crates create - Create a crate
• rewst-cli crates get - Get a single crate
• rewst-cli crates update - Update a crate

database-notification-errors - Manage database-notification-errors

• rewst-cli database-notification-errors - Get a single databasenotificationerror

delete-org-interpreter-responses - Manage delete-org-interpreter-responses

• rewst-cli delete-org-interpreter-responses <id> - Delete a deleteorginterpreterresponse

dropdown-options - Manage dropdown-options

• rewst-cli dropdown-options - Get a single dropdownoption

encoded-page-nodeses - Manage encoded-page-nodeses

• rewst-cli encoded-page-nodeses <id> - Get a single encodedpagenodes

feature-preview-settings - Manage feature-preview-settings

• rewst-cli feature-preview-settings create - Create a featurepreviewsetting
• rewst-cli feature-preview-settings get - Get a single featurepreviewsetting
• rewst-cli feature-preview-settings update - Update a featurepreviewsetting

foreign-object-references - Manage foreign-object-references

• rewst-cli foreign-object-references - Get a single foreignobjectreference

form-audit-entries - Manage form-audit-entries

• rewst-cli form-audit-entries - Get a single formauditentry

form-permission-states - Manage form-permission-states

• rewst-cli form-permission-states - Get a single formpermissionstate

forms - Manage forms

• rewst-cli forms create - Create a form
• rewst-cli forms get - Get a single form
• rewst-cli forms update - Update a form

integration-workflow-outputs - Manage integration-workflow-outputs

• rewst-cli integration-workflow-outputs - Create a integrationworkflowoutput

integrations - Manage integrations

• rewst-cli integrations - Get a single integration

interpreter-versions - Manage interpreter-versions

• rewst-cli interpreter-versions - Get a single interpreterversion

jinja-render-sessions - Manage jinja-render-sessions

• rewst-cli jinja-render-sessions <id> - Get a single jinjarendersession

jinja2-documentations - Manage jinja2-documentations

• rewst-cli jinja2-documentations - Get a single jinja2documentation

job-requested-responses - Manage job-requested-responses

• rewst-cli job-requested-responses - Create a jobrequestedresponse

logins - Manage logins

• rewst-cli logins - Get a single login

message-vote-statses - Manage message-vote-statses

• rewst-cli message-vote-statses - Get a single messagevotestats

microsoft-c-s-p-customers - Manage microsoft-c-s-p-customers

• rewst-cli microsoft-c-s-p-customers - Get a single microsoftcspcustomer

monaco-completion-items - Manage monaco-completion-items

• rewst-cli monaco-completion-items - Get a single monacocompletionitem

onboarding-questionnaire-responses - Manage onboarding-questionnaire-responses

• rewst-cli onboarding-questionnaire-responses create - Create a onboardingquestionnaireresponse
• rewst-cli onboarding-questionnaire-responses get - Get a single onboardingquestionnaireresponse

org-breadcrumbs - Manage org-breadcrumbs

• rewst-cli org-breadcrumbs - Get a single orgbreadcrumb

org-form-field-instances - Manage org-form-field-instances

• rewst-cli org-form-field-instances - Get a single orgformfieldinstance

org-interpreter-settings - Manage org-interpreter-settings

• rewst-cli org-interpreter-settings - Get a single orginterpretersetting

org-search-results - Manage org-search-results

• rewst-cli org-search-results - Get a single orgsearchresult

org-support-accesses - Manage org-support-accesses

• rewst-cli org-support-accesses - Create a orgsupportaccess

org-trigger-instances - Manage org-trigger-instances

• rewst-cli org-trigger-instances get - Get a single orgtriggerinstance
• rewst-cli org-trigger-instances update - Update a orgtriggerinstance

org-variables - Manage org-variables

• rewst-cli org-variables create - Create a orgvariable
• rewst-cli org-variables get - Get a single orgvariable
• rewst-cli org-variables update - Update a orgvariable

organization-audit-entries - Manage organization-audit-entries

• rewst-cli organization-audit-entries - Get a single organizationauditentry

organization-imports - Manage organization-imports

• rewst-cli organization-imports - Get a single organizationimport

organization-onboarding-crate-requirements - Manage organization-onboarding-crate-requirements

• rewst-cli organization-onboarding-crate-requirements - Get a single organizationonboardingcraterequirement

organization-onboarding-pack-requirements - Manage organization-onboarding-pack-requirements

• rewst-cli organization-onboarding-pack-requirements - Get a single organizationonboardingpackrequirement

organization-onboarding-requirements - Manage organization-onboarding-requirements

• rewst-cli organization-onboarding-requirements create - Create a organizationonboardingrequirement
• rewst-cli organization-onboarding-requirements get - Get a single organizationonboardingrequirement

organizations - Manage organizations

• rewst-cli organizations create - Create a organization
• rewst-cli organizations get - Get a single organization
• rewst-cli organizations update - Update a organization

pack-action-options - Manage pack-action-options

• rewst-cli pack-action-options - Get a single packactionoption

pack-bundles - Manage pack-bundles

• rewst-cli pack-bundles - Get a single packbundle

pack-configs - Manage pack-configs

• rewst-cli pack-configs create - Create a packconfig
• rewst-cli pack-configs get - Get a single packconfig
• rewst-cli pack-configs update - Update a packconfig

pack-delete-responses - Manage pack-delete-responses

• rewst-cli pack-delete-responses - Delete a packdeleteresponse

pack-resource-types-containers - Manage pack-resource-types-containers

• rewst-cli pack-resource-types-containers - Get a single packresourcetypescontainer

packs - Manage packs

• rewst-cli packs create - Create a pack
• rewst-cli packs get - Get a single pack
• rewst-cli packs update - Update a pack

packs-and-bundles-by-installed-states - Manage packs-and-bundles-by-installed-states

• rewst-cli packs-and-bundles-by-installed-states - Get a single packsandbundlesbyinstalledstate

page-nodes - Manage page-nodes

• rewst-cli page-nodes - Get a single pagenode

pages - Manage pages

• rewst-cli pages create - Create a page
• rewst-cli pages get - Get a single page
• rewst-cli pages update - Update a page

pending-tasks-aggregates - Manage pending-tasks-aggregates

• rewst-cli pending-tasks-aggregates - Get a single pendingtasksaggregate

permission-audit-log-lists - Manage permission-audit-log-lists

• rewst-cli permission-audit-log-lists - Get a single permissionauditloglist

permissions - Manage permissions

• rewst-cli permissions create - Create a permission
• rewst-cli permissions get - Get a single permission
• rewst-cli permissions update - Update a permission

psa-filter-optionses - Manage psa-filter-optionses

• rewst-cli psa-filter-optionses - Get a single psafilteroptions

psa-organizations - Manage psa-organizations

• rewst-cli psa-organizations - Get a single psaorganization

public-crates - Manage public-crates

• rewst-cli public-crates - Get a single publiccrate

reserved-organization-names - Manage reserved-organization-names

• rewst-cli reserved-organization-names - Get a single reservedorganizationname

robo-rewsty-config-values - Manage robo-rewsty-config-values

• rewst-cli robo-rewsty-config-values - Get a single roborewstyconfigvalue

role-organization-counts - Manage role-organization-counts

• rewst-cli role-organization-counts - Get a single roleorganizationcount

role-organization-rows - Manage role-organization-rows

• rewst-cli role-organization-rows - Get a single roleorganizationrow

role-user-counts - Manage role-user-counts

• rewst-cli role-user-counts - Get a single roleusercount

roles - Manage roles

• rewst-cli roles create - Create a role
• rewst-cli roles get - Get a single role
• rewst-cli roles update - Update a role

sensor-types - Manage sensor-types

• rewst-cli sensor-types - Get a single sensortype

site-domain-valids - Manage site-domain-valids

• rewst-cli site-domain-valids - Get a single sitedomainvalid

sites - Manage sites

• rewst-cli sites create - Create a site
• rewst-cli sites get - Get a single site
• rewst-cli sites update - Update a site

spice-d-b-check-results - Manage spice-d-b-check-results

• rewst-cli spice-d-b-check-results - Get a single spicedbcheckresult

tags - Manage tags

• rewst-cli tags create - Create a tag
• rewst-cli tags get - Get a single tag
• rewst-cli tags update - Update a tag

task-count-by-dates - Manage task-count-by-dates

• rewst-cli task-count-by-dates - Get a single taskcountbydate

task-count-by-hours - Manage task-count-by-hours

• rewst-cli task-count-by-hours - Get a single taskcountbyhour

task-logs - Manage task-logs

• rewst-cli task-logs create - Create a tasklog
• rewst-cli task-logs get - Get a single tasklog

templates - Manage templates

• rewst-cli templates create - Create a template
• rewst-cli templates get - Get a single template
• rewst-cli templates update - Update a template

time-saved-by-dates - Manage time-saved-by-dates

• rewst-cli time-saved-by-dates - Get a single timesavedbydate

time-saved-by-hours - Manage time-saved-by-hours

• rewst-cli time-saved-by-hours - Get a single timesavedbyhour

time-saved-group-by-orgs - Manage time-saved-group-by-orgs

• rewst-cli time-saved-group-by-orgs - Get a single timesavedgroupbyorg

time-saved-group-by-workflows - Manage time-saved-group-by-workflows

• rewst-cli time-saved-group-by-workflows - Get a single timesavedgroupbyworkflow

trigger-types - Manage trigger-types

• rewst-cli trigger-types - Get a single triggertype

triggers - Manage triggers

• rewst-cli triggers create - Create a trigger
• rewst-cli triggers get - Get a single trigger
• rewst-cli triggers update - Update a trigger

user-delegated-accesses - Manage user-delegated-accesses

• rewst-cli user-delegated-accesses - Get a single userdelegatedaccess

user-favorite-actions - Manage user-favorite-actions

• rewst-cli user-favorite-actions create - Create a userfavoriteaction
• rewst-cli user-favorite-actions update - Update a userfavoriteaction

user-invites - Manage user-invites

• rewst-cli user-invites create - Create a userinvite
• rewst-cli user-invites get - Get a single userinvite

user-preferenceses - Manage user-preferenceses

• rewst-cli user-preferenceses - Update a userpreferences

user-robo-rewsty-preferenceses - Manage user-robo-rewsty-preferenceses

• rewst-cli user-robo-rewsty-preferenceses get - Get a single userroborewstypreferences
• rewst-cli user-robo-rewsty-preferenceses update - Update a userroborewstypreferences

users - Manage users

• rewst-cli users create - Create a user
• rewst-cli users get - Get a single user
• rewst-cli users update - Update a user

workflow-execution-statses - Manage workflow-execution-statses

• rewst-cli workflow-execution-statses - Get a single workflowexecutionstats

workflow-executions - Manage workflow-executions

• rewst-cli workflow-executions - Get a single workflowexecution

workflow-notes - Manage workflow-notes

• rewst-cli workflow-notes - Get a single workflownote

workflow-patches - Manage workflow-patches

• rewst-cli workflow-patches - Get a single workflowpatch

workflow-stats-by-orgs - Manage workflow-stats-by-orgs

• rewst-cli workflow-stats-by-orgs - Get a single workflowstatsbyorg

workflow-tasks - Manage workflow-tasks

• rewst-cli workflow-tasks - Get a single workflowtask

workflows - Manage workflows

• rewst-cli workflows create - Create a workflow
• rewst-cli workflows get - Get a single workflow
• rewst-cli workflows update - Update a workflow

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

rewst-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match - fall back to --help or use a narrower query.

Recipes

Morning fleet check

rewst-cli health --org YOUR_ORG_ID --since 24h --agent

Single-call health verdict (succeeded/failed/running plus time saved) to start the day.

Triage overnight failures

rewst-cli failures --org YOUR_ORG_ID --since 12h --limit 25 --agent

List just the failed executions, newest first, to investigate what broke.

Narrow a verbose execution list

rewst-cli workflow-executions --where '{"orgId":"YOUR_ORG_ID"}' --limit 50 --agent --select data.id,data.status,data.createdAt,data.numSuccessfulTasks

Pull only the fields you need from a deeply nested execution payload so an agent isn't flooded with the full object.

Report automation ROI

rewst-cli roi --org YOUR_ORG_ID --since 30d --agent

Roll up humanSecondsSaved into hours/days saved and the top time-saving workflows for a client report.

Find config drift between two tenants

rewst-cli drift --org TENANT_A --against TENANT_B --agent

Diff org variables and installed packs to explain why automation works in one tenant but not the other.

Auth Setup

Rewst authenticates with a per-organization API client token sent as Authorization: Bearer <token>. Mint a token in the Rewst platform under Configuration > API Clients, then export it as REWST_API_TOKEN (or run rewst-cli auth set-token). The token is org-scoped, so most commands take an --org id for the tenant you are operating on.

Run rewst-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable - JSON on stdout, errors on stderr

• Filterable - --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  rewst-cli action-options get --agent --select id,name,status
  

• Previewable - --dry-run shows the request without sending

• Offline-friendly - sync/search commands can use the local SQLite store when available

• Non-interactive - never prompts, every input is a flag

• Explicit retries - use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set - piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

rewst-cli feedback "the --since flag is inclusive but docs say exclusive"
rewst-cli feedback --stdin < notes.txt
rewst-cli feedback list --json --limit 10

Entries are stored locally at ~/.local/share/rewst-cli/feedback.jsonl. They are never POSTed unless REWST_FEEDBACK_ENDPOINT is set AND either --send is passed or REWST_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration.

rewst-cli profile save briefing --json
rewst-cli --profile briefing action-options get
rewst-cli profile list --json
rewst-cli profile show briefing
rewst-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Async Jobs

For endpoints that submit long-running work, the generator detects the submit-then-poll pattern (a job_id/task_id/operation_id field in the response plus a sibling status endpoint) and wires up three extra flags on the submitting command:

Use async submission without --wait when you want to fire-and-forget; use --wait when you want one command to return the finished artifact.

Exit Codes

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help → show rewst-cli --help output
2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

1. Install the MCP binary (run the install script from the Prerequisites section, or see mcp-install.md for per-agent wire-up).
2. Register with Claude Code:

   claude mcp add rewst-mcp -- rewst-mcp
   

3. Verify: claude mcp list

Direct Use

1. Check if installed: which rewst-cli If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the --agent flag:

   rewst-cli <command> [subcommand] [args] --agent
   

4. If ambiguous, drill into subcommand help: rewst-cli <command> --help.