# Agent tools

Bash tools on this machine. Absolute paths. Relative paths do not resolve.

Root: `/Users/mark/Desktop/beargrassai/agent-tools/`

Read that tool's README for flags. Do not guess.

| Tool | Path | When |
|---|---|---|
| picviewer | `picviewer/` | Full-page shots, desktop and mobile |
| bgpdf | `bgpdf/` | Markdown to a client PDF |
| speedworks | `speedworks/` | Core Web Vitals for a named URL |
| aio-audit | `aio-audit/` | AIO readiness score |
| bgai-scout | `bgai-scout/` | Vouch for the instrument before you trust the number |
| bg-clone-zone | `bg-clone-zone/` | Full site clone |
| rclone | (no dir) | Back up `Clients/<folder>/`. See `client-storage.md` |

Run the four git reads yourself.

## Safety

Walled `spim-staging-*.pages.dev` hosts sit behind Access. A bare capture shots the login stub.

```bash
/Users/mark/Desktop/beargrassai/agent-tools/picviewer/pv-walled.sh <project-name>
```

Token: `/Users/mark/Desktop/studiosetup/spim-agents-access-token.txt`. Never print it.

`Clients/*` is storage. `rclone copy`, never `sync`. Check the Passport is mounted.

Finished PDFs leave `bgpdf/output/` and go in the client folder.

```bash
node /Users/mark/Desktop/beargrassai/agent-tools/picviewer/capture.mjs --url https://example.com
node /Users/mark/Desktop/beargrassai/agent-tools/bgpdf/bgpdf --profile neutral content.md
node /Users/mark/Desktop/beargrassai/agent-tools/speedworks/speedworks.mjs --url https://example.com --label preview
node /Users/mark/Desktop/beargrassai/agent-tools/aio-audit/aio-audit.mjs --url https://example.com --label client
node /Users/mark/Desktop/beargrassai/_archive/agent-tools/bg-clone-zone/src/clone.mjs --project /Users/mark/Desktop/beargrassai/_archive/agent-tools/bg-clone-zone/projects/<slug>.json
```