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

Automated K8s cluster health checking with Linear bug filing and deduplication.

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

"It works in my environment"

DevOps

Pages