Docs

wcheats CLI

Read-only command-line companion for auth, search, and command lookup.

The wcheats CLI is a command-line companion for WorkCheats. It helps you authenticate and read workspace content from a terminal — it does not execute scripts, run commands on targets, or perform operational actions on your behalf.

The CLI is Linux-first and currently read-only / limited in scope.

CLI overview

Use the CLI when you want quick terminal access to:

  • Confirm you are signed in
  • Search your library from the shell
  • Display a stored command's content
  • List workflows and view workflow summaries

Install and configure the CLI according to the instructions provided with your beta access materials. This documentation describes behaviour, not installation internals.

Current commands

The following commands are available today:

Authentication

  • wcheats auth login — sign in and store a session for CLI use
  • wcheats auth status — show whether you are authenticated
  • wcheats auth logout — clear the local CLI session

Search and lookup

  • wcheats search <query> — search workspace content by keyword
  • wcheats command show <identifier> — display a command's stored content

Workflows (read-only summary)

  • wcheats workflow list — list personal workflows
  • wcheats workflow show <uuid> — show workflow summary metadata (no step bodies or variable resolution)

These commands read and display content only. Copy and run commands yourself in authorised environments.

Security model

  • The CLI uses the same account and workspace boundaries as the web app.
  • Stored CLI credentials are local to your machine — protect your workstation like any other security tool.
  • The CLI never executes command bodies, workflow steps, or imported scripts.
  • Treat displayed content as operational text, not as instructions WorkCheats has validated for your engagement.

See Security & Responsible Use for authorised use and untrusted content rules.

No script execution

WorkCheats — web app and CLI — does not execute scripts or commands. The CLI shows content; your shell and tools run separately under your control.

If documentation or marketing elsewhere implies automatic execution, that is incorrect for the current product.

Roadmap

The following CLI capabilities are not available yet:

  • Masked variables — display variable values with masking rules in the CLI
  • Output capture and placeholders — record session outputs into structured fields from the CLI
  • Command copy, session control, or report capture from the terminal

Roadmap items may change before release. Do not build operational processes that depend on them today.

See Workflows, Variables, and Sessions for related web app features.