add claude files [ci skip]

.claude/CLAUDE.md

@@ -6,12 +6,23 @@
 - **Use `/update-knowledge` command**: Or edit this file directly to add learnings
 
 ## Execution Environment (CRITICAL)
-- **File operations** (Read, Edit, Write, Glob, Grep): Run locally at `/Volumes/wizard/code/infra`
-- **Git commands**: Run locally (git status, git log, git diff, etc.)
-- **ALL other commands**: Use the remote executor relay (kubectl, terraform, helm, python, etc.)
+- **Prefer running commands directly first** - only use remote executor as fallback if local execution fails
 
-### Remote Command Execution (ALWAYS USE THIS)
-For any command that is not file editing or git, use the file-based relay:
+### Commands that work LOCALLY (macOS)
+- **File operations**: Read, Edit, Write, Glob, Grep tools
+- **Git commands**: git status, git log, git diff, git add, git commit, git reset, etc.
+- **Basic shell**: ls, cat, head, tail, find, grep, etc.
+
+### Commands that REQUIRE REMOTE EXECUTOR
+- **terraform**: apply, plan, init, state - needs cluster access
+- **kubectl**: all k8s commands - needs cluster access
+- **helm**: chart operations - needs cluster access
+- **docker**: container operations on remote hosts
+- **ssh**: connections to infrastructure nodes
+- **Any command interacting with**: Proxmox, Kubernetes cluster, NFS server, other infrastructure
+
+### Remote Command Execution (FALLBACK)
+For commands that fail locally, use the file-based relay:
 
 **To execute a remote command:**
 ```bash
@@ -151,6 +162,7 @@ Edge/Aux (tier 3-4):
 - Use `GIT_OPTIONAL_LOCKS=0` prefix if git hangs
 - **Local SSH is blocked** - use remote executor to push: `echo "git push origin master" > .claude/cmd_input.txt`
 - Always commit only specific files you changed, not everything
+- **ALWAYS ask user before pushing to remote** - never push without explicit confirmation
 
 ## Prometheus Alerts
 - Alert rules are in `modules/kubernetes/monitoring/prometheus_chart_values.tpl`

.claude/commands/add-service.md

@@ -0,0 +1,16 @@
+# Add New Service
+
+Help create a new Kubernetes service module.
+
+Service name: $ARGUMENTS
+
+Steps:
+1. Create directory at modules/kubernetes/<service-name>/
+2. Create main.tf with:
+   - Namespace resource
+   - Deployment with appropriate container
+   - Service resource
+   - Ingress with TLS and standard annotations
+3. Use existing patterns from similar services
+4. Add module reference in main.tf
+5. Update .claude/CLAUDE.md with new service version

.claude/commands/kubectl.md

@@ -0,0 +1,16 @@
+# Kubectl Command
+
+Run kubectl commands on the cluster via the remote executor.
+
+Use the remote executor relay:
+```bash
+echo "kubectl $ARGUMENTS" > /System/Volumes/Data/mnt/code/infra/.claude/cmd_input.txt
+sleep 2 && cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_status.txt
+cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_output.txt
+```
+
+Examples:
+- `/kubectl get pods -A` - List all pods
+- `/kubectl get pods -n immich` - List pods in immich namespace
+- `/kubectl logs -n immich deploy/immich-server` - View logs
+- `/kubectl describe pod -n monitoring <pod>` - Describe a pod

.claude/commands/list-services.md

@@ -0,0 +1,11 @@
+# List All Services
+
+List all Kubernetes services deployed in this infrastructure.
+
+```bash
+ls -1 /System/Volumes/Data/mnt/code/infra/modules/kubernetes/
+```
+
+Provide a summary of the services, grouped by category if possible (media, monitoring, productivity, etc.).
+
+Note: This command runs locally since it only reads the filesystem.

.claude/commands/service-version.md

@@ -0,0 +1,10 @@
+# Check Service Version
+
+Find the version of a specific service deployed in this infrastructure.
+
+Search for the service name in modules/kubernetes/ and extract:
+1. The image version/tag being used
+2. Any version variables defined
+3. The Helm chart version if applicable
+
+Service to check: $ARGUMENTS

.claude/commands/tf-apply.md

@@ -0,0 +1,13 @@
+# Terraform Apply
+
+Run terraform apply to deploy infrastructure changes via the remote executor.
+
+Use the remote executor relay:
+```bash
+echo "terraform apply -target=module.kubernetes_cluster.module.<service> -auto-approve" > /System/Volumes/Data/mnt/code/infra/.claude/cmd_input.txt
+sleep 2 && cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_status.txt
+# Wait for done:N status, then read output
+cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_output.txt
+```
+
+ALWAYS use -target to speed up execution. Monitor the output and report any errors or successful completions.

.claude/commands/tf-plan.md

@@ -0,0 +1,13 @@
+# Terraform Plan
+
+Run terraform plan to preview infrastructure changes via the remote executor.
+
+Use the remote executor relay:
+```bash
+echo "terraform plan -target=module.kubernetes_cluster.module.<service>" > /System/Volumes/Data/mnt/code/infra/.claude/cmd_input.txt
+sleep 2 && cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_status.txt
+# Wait for done:N status, then read output
+cat /System/Volumes/Data/mnt/code/infra/.claude/cmd_output.txt
+```
+
+ALWAYS use -target to speed up execution. Summarize the planned changes, highlighting any resources being destroyed or recreated.

.claude/commands/update-knowledge.md

@@ -0,0 +1,12 @@
+# Update Knowledge Base
+
+Update the .claude/CLAUDE.md knowledge file with new learnings.
+
+Add or update information based on recent discoveries about:
+- Service versions
+- Infrastructure patterns
+- Important configurations
+- Useful commands
+- Troubleshooting notes
+
+Context to add: $ARGUMENTS

.claude/settings.json

@@ -0,0 +1,12 @@
+{
+  "project": {
+    "name": "Home Infrastructure",
+    "type": "terraform",
+    "description": "Kubernetes cluster on Proxmox with self-hosted services"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(ssh:*)"
+    ]
+  }
+}