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 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, worker CLI execution, test suites |
2. Command Reference by Tool
A. Google Jules CLI (jules)
```bash
./scripts/jules-review-loop.sh --pr <pr-number>
```
```bash
jules new --repo <owner>/<repo> "<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
vercel deploy
```
E. Python Package Manager (uv)
uv. Never invoke bare pip install or python -m venv.```bash
uv venv
uv sync
uv run pytest
uv add <pkg>
```
F. Node.js Package Manager (pnpm)
pnpm. Never invoke npm or yarn. Only commit pnpm-lock.yaml.```bash
pnpm install
pnpm add <pkg>
pnpm up
pnpm run build
pnpm run test
```
3. Recovery & Re-Authentication Runbook
If any CLI tool reports authentication expiration or failure, alert the human developer with the exact command:
gh auth loginvercel loginneonctl authdocker loginmake login-<service> target). Never work around it by pasting tokens into .env files, and never run interactive browser logins on the human's behalf.