GADHS pi

On this page
GADHS pi

GADHS pi is the Georgia Department of Human Services distribution of the pi coding agent. One install gives you Claude on the agency’s Vertex AI, four ready-made working modes, safety rails that stay out of your way, helper agents, and the agency’s working agreements — kept current by keeping the package current.

(“DHS” throughout means the Georgia Department of Human Services, not the federal one.)

Install

# 1. Registry access for @gadhs packages (once)
npm config set @gadhs:registry https://gitlab.com/api/v4/groups/55134190/-/packages/npm/

# 2. The distribution
pi install npm:@gadhs/pi

# 3. Google auth for the agency's Claude models
export ANTHROPIC_VERTEX_PROJECT_ID=<your-team's-gcp-project>
gcloud auth application-default login

Start pi in a repo, press F2 to pick a mode, and work. In a brand-new repo, /gadhs-init scaffolds the standard project file.

What you get

Models on Vertex AI

Claude (Opus, Sonnet, Haiku, research models), Gemini, and the Model-as-a-Service catalogue (Grok, gpt-oss, Kimi, Qwen, MiniMax) through the agency’s GCP projects, with the right region per model and nothing to log in to. When your Google session expires mid-task, pi waits for you to re-login and resumes by itself.

Working modes

auto (build things; routine actions are instant, risky ones are checked), plan (investigate without changing anything), manual (you approve every command), yolo (permission questions answer themselves — coding standards still apply). Switch with F2. Details.

Safety that mostly stays invisible

Fast rules handle the obvious; a small model reviews only genuinely ambiguous actions for danger — never for style. When something is blocked, the transcript says who blocked it and why.

A second pair of eyes on every commit

Before a commit lands, a model that did not write the change — and is never weaker than the one that did — reads the staged diff cold and answers a fixed checklist, with file-and-line citations. Findings come back to the agent (and to you); the same diff then commits on retry. It advises; it does not veto.

An agent that asks instead of guessing

The agent can put a real question to you mid-task (with options to pick from), propose a plan and wait for your explicit approval before touching anything, and remember repo facts you confirm (/remember, /memory).

Workflow built in

Commit-message format, license headers, branch discipline and attribution are handled or checked automatically — you find out when you write, not when CI fails.

Helper agents

Explore / Verify / Research subagents for delegating investigation and checks, with their answers validated against declared contracts.

Agency guidance, current

The working agreements arrive with the package and update with it, plus a language profile matched to your repo (Rust, TypeScript, Python, Java) — nothing to copy in, nothing to drift.

Agency look

Orchard themes matching the docs sites: gadhs-human-services- and gadhs-foundation-, light and dark.

Where next

Edit this page · latest