Authenticated CLI Tooling & Operations Guide

This repository treats specialized developer CLI tools as first-class automation interfaces. AI agents and developers should prefer these authenticated CLIs over manual workflows.

1. Tooling Matrix & Authentication Overview

| Tool | CLI Binary | Auth Check Command | Primary Usage in System |

|---|---|---|---|

| **Google Jules CLI** | `jules` | `jules version` | Autonomous 38-dimension code review, remediation sessions, patch application |

| **GitHub CLI** | `gh` | `gh auth status` | Pull requests, issues, repo management, label sync, Actions monitoring |

| **Vercel CLI** | `vercel` | `vercel whoami` | Frontend and Observatory serverless deployments, preview inspection |

| **Neon CLI** | `neonctl` | `neonctl me` | Database branching, connection strings, migrations, schema isolation |

| **Docker CLI** | `docker` | `docker info` | Image builds, multi-stage validation, local test containers |

| **Python Package Manager** | `uv` | `uv --version` | Virtualenv management, dependency syncing, type checking |

| **Node.js Package Manager** | `pnpm` | `pnpm --version` | Frontend dependencies, Next.js build, Biome formatting/linting |

| **Go Toolchain** | `go` | `go version` | Backend API compilation, backup worker CLI execution, test suites |

2. Command Reference by Tool

A. Google Jules CLI (`jules`)

```bash

./scripts/jules-review-loop.sh --pr <pr-number>

make jules-review PR=<pr-number>

```

```bash

jules new --repo MishraShardendu22/github-backup-automation-system "<task-prompt>"

```

```bash

jules remote list --session

```

```bash

jules remote pull --session <session-id> --apply

```

B. GitHub CLI (`gh`)

```bash

gh pr create --base main --head <branch-name> --assignee "@me" --label "type/<type>,area/<area>,status/ready-for-review" --body "<body-markdown>"

```

```bash

gh pr status

gh pr checks <pr-number>

```

```bash

gh run list --limit 10

```

C. Neon CLI (`neonctl`)

```bash

neonctl branches list --project-id <project-id> --output json

```

```bash

neonctl branches create --project-id <project-id> --name <branch-name> --parent production --output json

```

```bash

neonctl connection-string <branch-name> --project-id <project-id> --ssl require

```

D. Vercel CLI (`vercel`)

```bash

vercel ls

```

```bash

cd frontend && vercel deploy

```

3. Recovery & Re-Authentication Runbook

If any CLI tool reports authentication expiration or failure, alert the human developer with the exact command: