Menu
Coder workspace environment for hahomelabs.com deployments. Includes networking, ports, convex config, nhost config
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Initial Convex workspace setup in Coder workspaces with self-hosted Convex deployment, authentication configuration, Docker setup, and environment variable generation
Self-hosted Convex development in Coder workspaces with authentication, queries, mutations, React integration, and environment configuration
Guides self-hosted Convex deployment, authentication setup, environment configuration, troubleshooting, and production deployment considerations.
Manages git operations including commits, pull requests, merge requests, and branching. Use when creating commits, handling git conflicts, managing branches, or reviewing git history. Enforces clean commit messages without author attribution.
Refactors Claude Code skills to reduce token usage 80-95% using Progressive Disclosure Architecture (PDA). Splits monolithic skills into orchestrator + reference files, extracts scripts, creates reference/ directories. Use when optimizing skills, improving skill efficiency, refactoring large/bloated skills, reducing token costs, applying PDA, modularizing skills, breaking down skills, or converting encyclopedia-style skills to orchestrator pattern.
Coder CLI commands for workspace management, templates, and platform operations
| name | coder-hahomelabs |
| description | Coder workspace environment for hahomelabs.com deployments. Includes networking, ports, convex config, nhost config |
Context for projects running in this Coder workspace environment at hahomelabs.com.
You are running in a Coder development workspace:
| Property | Value |
|---|---|
| OS | Linux (Ubuntu/Debian-based) |
| Architecture | x86_64 |
| Container Runtime | Docker-in-Docker capability via envbox |
| Infrastructure | Kubernetes-managed workspace with persistent storage |
| Networking | Internal cluster networking with port forwarding capabilities |
| Shell | Bash |
| System Package Manager | apt/apt-get |
The following tools are pre-installed and available in this workspace:
| Tool | Command | Description |
|---|---|---|
| Docker | docker, docker-compose | Full container management capability |
| Kubernetes CLI | kubectl | Cluster access and management (requires VPN) |
| GitHub CLI | gh | Pre-configured with auto OAuth token refresh |
| VS Code Server | IDE with extensions | |
| Coder CLI | coder | Coder-specific workspace operations |
| PM2 | pm2 | Process manager for keeping Node.js services running in the background |
| Node.js (with pnpm) | node, pnpm | Node.js runtime and pnpm package manager |
| Convex CLI | npx convex | Available when Convex feature is enabled |
| Claude Code | claude | AI-powered CLI (custom installation via base image) |
| ccusage | ccusage | Claude Code usage monitoring utility |
| OpenCode | opencode | AI CLI tool |
Services use this URL pattern:
https://<service>--<workspace-name>--<username>.coder.hahomelabs.com
| Service | Port | URL Example |
|---|---|---|
| Dev server | 3000 | https://app--myproject--johndoe.coder.hahomelabs.com |
| Prod/preview | 3010 | https://app-prod--myproject--johndoe.coder.hahomelabs.com |
IMPORTANT: Always use full URLs. Do NOT use localhost: URLs as they cause issues with remote services, authentication, cookies, and cross-origin requests.
When enabled, these environment variables are available:
POSTGRES_HOST # <workspace-full-name>-db-rw
POSTGRES_PORT # 5432
POSTGRES_DATABASE # app
POSTGRES_USER # app
POSTGRES_PASSWORD # Auto-generated
DATABASE_URL # postgres://app:password@host:port/app
DIRECT_URL # postgres://app:password@host:port/app
Database details:
appapp${workspace_full_name}-db-rwworkspace-cnpg-${owner}-${name}-${short_id}When enabled, these environment variables are available:
S3_ENDPOINT # https://s3.us-central-1.hahomelabs.com
S3_REGION # us-central-1
S3_BUCKET # workspace-${owner}-${name}-${short_id}
AWS_S3_ENDPOINT # Same as S3_ENDPOINT
AWS_BUCKET # Same as S3_BUCKET
S3_BACKUP_ENDPOINT # https://s3.us-central-1.hahomelabs.com
S3_BACKUP_BUCKET # workspace-cnpg-${owner}-${name}-${short_id}
S3 details:
https://s3.us-central-1.hahomelabs.comus-central-1When enabled:
/convex): https://convex--<workspace>--<user>.coder.hahomelabs.com/convex-api): https://convex-api--<workspace>--<user>.coder.hahomelabs.com/convex-site): https://convex-site--<workspace>--<user>.coder.hahomelabs.com/convex-s3-proxy): https://convex-s3-proxy--<workspace>--<user>.coder.hahomelabs.comnpx convexWhen enabled:
/nhost-dashboard): https://nhost-dashboard--<workspace>--<user>.coder.hahomelabs.com/hasura): https://hasura--<workspace>--<user>.coder.hahomelabs.com/mailhog): https://mailhog--<workspace>--<user>.coder.hahomelabs.comhttps://nhost-auth--<workspace>--<user>.coder.hahomelabs.comhttps://nhost-functions--<workspace>--<user>.coder.hahomelabs.comhttps://nhost-storage--<workspace>--<user>.coder.hahomelabs.comhttps://nhost-graphql--<workspace>--<user>.coder.hahomelabs.comAI requests route through LiteLLM proxy with budget controls:
# Environment variables (ask user before accessing)
OPENAI_BASE_URL # https://llm-gateway.hahomelabs.com/v1
LITELLM_BASE_URL # https://llm-gateway.hahomelabs.com
ANTHROPIC_AUTH_TOKEN # Per-user API key (development)
LITELLM_APP_API_KEY # Per-user API key (applications)
Model mapping:
sudo apt-get update
sudo apt-get install <package>
Check lockfile to determine which to use:
pnpm-lock.yaml → Use pnpmyarn.lock → Use yarnpackage-lock.json → Use npmbun.lockb → Use bunpm2 status # Check status
pm2 logs # View all logs
pm2 logs <app> # View app logs
pm2 logs --lines 50 --nostream # View recent log entries
pm2 restart <app> # Restart app
docker ps # List containers
docker logs <container>
docker logs -f <container> # Follow logs
| Script | Location | When it runs |
|---|---|---|
| Startup | start.sh | Workspace starts |
| Shutdown | stop.sh | Workspace stops |
Scripts are executed automatically by the Coder agent. Use them for:
Note: Startup script runs with 60-second timeout, then backgrounds if still running.
src/components/Header.tsx/usr/local/bin/toolCRITICAL: Before using or changing ANY environment variable, you MUST:
To check available environment variables:
env | grep -i <pattern> # Search for specific variables
env # List all environment variables
printenv # Alternative way to list all
echo $VAR_NAME # Check specific variable
Never modify environment variables without explicit user permission, as they may affect:
GitHub CLI (gh) is pre-configured with automatic OAuth token refresh. The token refreshes automatically via a wrapper function in .bashrc.
/home/coder/project)app, user is always appYou can help with:
coder-workspace-management skill