gws-install

1# Google Workspace CLI — Quick Install
2 
3Install `gws` on an additional machine using OAuth credentials from a previous setup. Produces an authenticated CLI with all agent skills ready to use.
4 
5**Prerequisite**: The user must have `client_secret.json` from a previous `gws-setup` (or from Google Cloud Console). If they don't have it, use the `gws-setup` skill instead.
6 
7## Workflow
8 
9### Step 1: Pre-flight Checks
10 
11```bash
12which gws && gws --version
13ls ~/.config/gws/client_secret.json
14gws auth status
15```
16 
17If already authenticated with the right scopes, skip to Step 4.
18 
19### Step 2: Install the CLI
20 
21```bash
22npm install -g @googleworkspace/cli
23gws --version
24```
25 
26### Step 3: Set Up Credentials
27 
28Ask the user to provide their `client_secret.json`. Three options:
29 
30**Option A — Paste the JSON content:**
31 
32Ask the user to paste the JSON. Write it to `~/.config/gws/client_secret.json`:
33 
34```bash
35mkdir -p ~/.config/gws
36```
37 
38Expected format:
39 
40```json
41{
42  "installed": {
43    "client_id": "...",
44    "project_id": "...",
45    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
46    "token_uri": "https://oauth2.googleapis.com/token",
47    "client_secret": "...",
48    "redirect_uris": ["http://localhost"]
49  }
50}
51```
52 
53**Option B — File path:**
54 
55If the user has the file locally (e.g. in Downloads):
56 
57```bash
58mkdir -p ~/.config/gws
59cp /path/to/client_secret.json ~/.config/gws/client_secret.json
60```
61 
62**Option C — Environment variables:**
63 
64```bash
65export GOOGLE_WORKSPACE_CLI_CLIENT_ID="your-client-id"
66…