Files
org/TOOLS.md
T
Chris Farhood 3a6b6db197 Add Pixel Patty (UAT) and move Playwright MCP from Regina
Split QA and UAT responsibilities: Regina keeps code-level QA
(vitest, PR review, CI health) on claude_local/sonnet, while
new agent Pixel Patty handles E2E browser testing via Playwright
MCP on opencode_local/minimax — reducing token cost for the
browser-heavy automation work.

- Add engineering/patty/ with full agent file set
- Remove Playwright MCP references from Regina's SOUL.md
- Delete Regina's stale opencode.json (now on claude_local)
- Update roster, directory tree, and shared tools

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 20:35:45 -04:00

52 lines
2.1 KiB
Markdown

# Privileged Escalation — Shared Tools
## GitHub Authentication
export GH_TOKEN=$(bash /paperclip/privilegedescalation/agents/get-github-token.sh)
Run this at the start of every heartbeat. Sets `GH_TOKEN` for `gh` and `git`.
## Paperclip API
Auto-injected env vars:
- `PAPERCLIP_API_URL` — base URL (fall back to `http://localhost:3100`)
- `PAPERCLIP_API_KEY` — short-lived JWT for this run
- `PAPERCLIP_RUN_ID` — include on all mutating requests
## Available Tools
| Tool | Purpose |
|---|---|
| `gh` | GitHub CLI — issues, PRs, CI runs, repo management |
| `git` | Version control — branches, commits, PRs |
| `curl` | HTTP requests — Paperclip API, external services |
| `jq` | JSON parsing and formatting |
| `node` / `npm` / `pnpm` / `npx` | Node.js runtime and package management |
| `python3` | Python scripting |
| `pnpm paperclipai` | Paperclip CLI — issue/agent operations |
| `kubectl` | Kubernetes CLI — read-only cluster-wide, read-write in `privilegedescalation` and `privilegedescalation-dev` |
| `kubeseal` | Seal Kubernetes secrets for safe git storage (Bitnami Sealed Secrets) |
## Repos
| Repo | Owner | Purpose |
|---|---|---|
| `privilegedescalation/agents` | Board | Agent profiles and configuration (this repo) |
| `privilegedescalation/headlamp-*` | Gandalf | Headlamp plugin repos |
## MCP Servers
| Server | Endpoint | Available To | Purpose |
|--------|----------|-------------|---------|
| `minimax-search` | Local (uvx) | VP Product, CMO | Web search and image understanding |
| `playwright-privilegedescalation` | `http://playwright-privilegedescalation.paperclip.svc.cluster.local:3000/sse` | Pixel Patty (UAT) | Playwright browser automation for E2E testing |
MCP server configs live in each agent's `.mcp.json` (claude_local) or `opencode.json` (opencode_local).
## GitHub Actions Runners
Self-hosted ARC runners are available at the org level. Use `runs-on: runners-privilegedescalation` in workflows.
Runners scale to zero when idle — if no runner pods are visible, they will start automatically when a workflow is triggered.