jordan/rdev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Remote Developer - Claude Code instances in isolated Kubernetes pods
5 Commits 1 Branch 0 Tags 4.7 MiB
Go 84.7%
Shell 6.8%
TypeScript 5.7%
HTML 1.9%
PLpgSQL 0.4%
Other 0.2%
4a042a8b71
Go to file
jordan 4a042a8b71 feat: Add rdev-api Go server with OpenAPI docs 
Implements a fully documented API server following the aeries chassis pattern:

- pkg/api: Simplified chassis with App, Response helpers, and OpenAPI builder
- cmd/rdev-api: Entry point with full OpenAPI spec for all v0.4 endpoints
- internal/handlers: Stubbed project handlers (list, get, claude, shell, git, events)

Endpoints:
- GET  /health, /ready     - Health checks
- GET  /docs, /openapi.json - Scalar API docs
- GET  /projects           - List projects
- GET  /projects/{id}      - Get project
- POST /projects/{id}/claude, shell, git - Run commands
- GET  /projects/{id}/events - SSE streaming

Uses Scalar for dark-mode API documentation at /docs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 20:56:27 -07:00
cmd/rdev-api feat: Add rdev-api Go server with OpenAPI docs 2026-01-24 20:56:27 -07:00
deployments/k8s/base fix: Use ghcr.io and build for amd64 2026-01-24 20:04:34 -07:00
docs docs: Add v0.1.0 history and update reference with k3s notes 2026-01-24 20:09:03 -07:00
history docs: Add v0.1.0 history and update reference with k3s notes 2026-01-24 20:09:03 -07:00
internal/handlers feat: Add rdev-api Go server with OpenAPI docs 2026-01-24 20:56:27 -07:00
pkg/api feat: Add rdev-api Go server with OpenAPI docs 2026-01-24 20:56:27 -07:00
scripts fix: Use ghcr.io and build for amd64 2026-01-24 20:04:34 -07:00
.gitignore Initial commit: rdev v0.1 base case 2026-01-24 19:24:07 -07:00
CLAUDE.md Initial commit: rdev v0.1 base case 2026-01-24 19:24:07 -07:00
Dockerfile Initial commit: rdev v0.1 base case 2026-01-24 19:24:07 -07:00
go.mod feat: Add rdev-api Go server with OpenAPI docs 2026-01-24 20:56:27 -07:00
go.sum feat: Add rdev-api Go server with OpenAPI docs 2026-01-24 20:56:27 -07:00
PLAN.md docs: Add comprehensive development plan (v0.1-v0.6) 2026-01-24 20:17:46 -07:00
README.md Initial commit: rdev v0.1 base case 2026-01-24 19:24:07 -07:00

README.md

rdev - Remote Developer

Run Claude Code in isolated Kubernetes pods on your k3s cluster.

Quick Start

# 1. Set kubeconfig (REQUIRED - this is k3s, not GKE)
export KUBECONFIG=~/.kube/orchard9-k3sf.yaml

# 2. Authenticate Claude locally (if not already)
claude login

# 3. Create credentials secret
./scripts/create-credentials-secret.sh

# 4. Deploy
./scripts/deploy.sh

# 5. Verify
./scripts/verify.sh

Usage

# Check Claude version
kubectl exec -n rdev claudebox-0 -- claude --version

# Interactive Claude session
kubectl exec -it -n rdev claudebox-0 -- claude "what can you help me with?"

# Run in workspace
kubectl exec -it -n rdev claudebox-0 -- bash
cd /workspace
claude "create a hello world go program"

Architecture

k3s cluster
└── rdev namespace
    └── claudebox-0 (StatefulSet)
        ├── Claude Code CLI
        ├── /workspace (20Gi PVC via Longhorn)
        └── /root/.claude (credentials from secret)

Roadmap

  • v0.1: Base case - single claudebox pod
  • v0.2: Real workspace mounting (pantheon, aeries)
  • v0.3: Git integration (push/pull)
  • v0.4: Discord bot control
  • v0.5: Streaming output
  • v0.6: Multi-project routing

Development

# Build image locally
docker build -t rdev-claudebox:dev .

# Build and push to Artifact Registry
./scripts/build-push.sh v0.1.0

Troubleshooting

# Check pod status
kubectl get pods -n rdev

# View pod logs
kubectl logs claudebox-0 -n rdev

# Describe pod for events
kubectl describe pod claudebox-0 -n rdev

# Check credentials mount
kubectl exec -n rdev claudebox-0 -- ls -la /root/.claude/