K8s custom controller that orchestrated AI agent runs via AgentTask CRDs. Deprecated — replaced by native K8s CronJobs. Kept in the repo as a reference project.

Agent Controller

How the infra/ai-agents/ stack is organized, deployed, and kept in sync across the M1 and kyle-m2 Mac clusters via ArgoCD GitOps.

AI Agents Infrastructure

From factory-reset Mac to running AI agent K8s stack — single-command bootstrap, Vault secret management, and post-reboot recovery.

Bootstrap & Recovery

How to set up a Cloudflare Tunnel into the K8s cluster, with Traefik as a reverse proxy and Cloudflare Access for auth. Enables remote access to ArgoCD, webhooks, and other internal services via pai.pericak.com.

Cloudflare Tunnel + Traefik: Remote Access Setup

AI code review tool. Reviews PRs on GitHub automatically, runs locally via CLI and Claude Code plugin, configured with .coderabbit.yaml.

CodeRabbit

DEPRECATED — superseded by pai-self-improver. Kept for ad-hoc cluster checks.

Health Check Agent

Gotchas, decisions, and patterns discovered while building the Ansible-managed Mac workstation setup.

Mac Setup Learnings

Decision log from running bootstrap.sh and playbook.yml on a fresh Mac, including fixes applied.

Mac Setup Run Log — 2026-03-18

How OpenObserve is deployed to the pai-m1 K8s cluster — Helm chart, Vault-backed credentials, Traefik IngressRoute at pai.pericak.com/obs.

OpenObserve: Observability on K8s

Deploy feature branch previews alongside production using Traefik header-based routing and ArgoCD Pull Request generator.

Preview Environments: Header-Based Branch Routing

Cross-tool AI rule management. Maintains a single source of truth for AI assistant instructions, generating tool-specific config files for Claude Code, Cursor, and others.

Ruler

<p>Tooling for code quality, agent orchestration, and cross-tool
configuration management.</p>
<h2 id="pages">Pages</h2>
<ul>
<li><a href="/wiki/devops/ruler.html">Ruler</a> — Cross-tool AI rule inventory</li>
<li><a href="/wiki/devops/coderabbit.html">CodeRabbit</a> — False positive patterns and path_instructions</li>
<li><a href="/wiki/devops/ai-agents-infra.html">AI Agents Infrastructure</a> — Stack layout, ArgoCD GitOps, per-cluster config, bootstrap</li>
<li><a href="/wiki/devops/agent-controller.html">Agent Controller</a> — K8s controller for autonomous AI agent runs via CRDs</li>
<li><a href="/wiki/devops/bootstrap.html">Bootstrap &#x26; Recovery</a> — Single-command bootstrap, Vault secrets, post-reboot recovery</li>
<li><a href="/wiki/devops/mac-setup-learnings.html">Mac Setup Learnings</a> — Gotchas and patterns from the Ansible-managed Mac setup</li>
<li><a href="/wiki/devops/mac-setup-run-log.html">Mac Setup Run Log</a> — Per-run decision log from bootstrap execution</li>
<li><a href="/wiki/devops/preview-environments.html">Preview Environments</a> — Header-based branch routing with Traefik and ArgoCD</li>
</ul>


Development operations tooling: cross-tool AI rule management, code review automation, and agent orchestration.

Kyle Pericak

DevOps

Pages