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)
- Review PR:
./scripts/jules-review-loop.sh --pr <pr-number> make jules-review PR=<pr-number> - Dispatch Remediation Task:
jules new --repo MishraShardendu22/github-backup-automation-system "<task-prompt>" - List Active Sessions:
jules remote list --session - Pull and Apply Session Patch:
jules remote pull --session <session-id> --apply
B. GitHub CLI (gh)
- Create Pull Request:
gh pr create --base main --head <branch-name> --assignee "@me" --label "type/<type>,area/<area>,status/ready-for-review" --body "<body-markdown>" - View PR Status & Checks:
gh pr status gh pr checks <pr-number> - Check Actions Runs:
gh run list --limit 10
C. Neon CLI (neonctl)
- List Branches:
neonctl branches list --project-id <project-id> --output json - Create Ephemeral Staging Branch:
neonctl branches create --project-id <project-id> --name <branch-name> --parent production --output json - Get Connection String:
neonctl connection-string <branch-name> --project-id <project-id> --ssl require
D. Vercel CLI (vercel)
- Inspect Deployments:
vercel ls - Deploy Preview:
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:
- GitHub CLI:
gh auth login - Vercel CLI:
vercel login - Neon CLI:
neonctl auth - Docker Hub:
docker login