현재 릴리스: 1.4.0.

Claude Code, Codex 및 Gemini 용 Homelab 플러그인 허브. 이 저장소는 homelab-core] 플러그인, 번들된 기술 전용 통합, 에이전트, 명령 및 공유 자격 부츠 스트랩에 대한 진실의 소스입니다.

개요

claude-homelab는 한 번에 세 가지 역할을합니다.

• homelab-core clude 마켓을 통해 출판된 플러그인
• 16 번들 기술 전용 서비스 통합을 위한 canonical mono-repo
• Codex 및 Gemini 확장의 소스는 동일한 워크플로 표면을 미러링합니다.

repo 루트는 플러그인 루트입니다. ~/.claude/ 또는 ~/.claude/plugins/cache/]에서 생성된 사본을 직접 편집하지 마십시오.

설치

Claude 마켓

설치 후, Claude Code는 플러그인을 ~/.claude/plugins/cache/로 다운로드합니다. 이 경로에 symlinks가 생성되지 않습니다.

Bash / symlink 설치

또는 이미 repo 복제를 가지고 있다면:

설치자:

1. 사전 예약 확인(git], jq], curl])
2. ~/claude-homelab]에 repo를 Clones (또는 그것이 존재하는 경우에 잡아당기기)
3. setup-creds.sh] - ~/.claude-homelab/.env]]에서 .env.example] chmod 600]를 생성한다
4. setup-symlinks.sh 실행 - symlinks 기술, 에이전트, 및 ~/.claude/]로 명령
5. 명세.

Claude Homelab

Current release: 1.4.0.

Homelab plugin hub for Claude Code, Codex, and Gemini. This repository is the source of truth for the homelab-core plugin, bundled skill-only integrations, agents, commands, and shared credential bootstrapping.

Overview

claude-homelab serves three roles at once:

• The homelab-core plugin published through the Claude marketplace
• The canonical mono-repo for 16 bundled skill-only service integrations
• The source for Codex and Gemini extension manifests that mirror the same workflow surface

The repo root is the plugin root. Do not edit generated copies in ~/.claude/ or ~/.claude/plugins/cache/ directly.

Installation

Claude marketplace

/plugin marketplace add jmagar/claude-homelab
/plugin install homelab-core @jmagar-claude-homelab

After install, Claude Code downloads the plugin into ~/.claude/plugins/cache/. No symlinks are created on this path.

Bash / symlink install

curl -sSL https://raw.githubusercontent.com/jmagar/claude-homelab/main/scripts/install.sh | bash

Or, if you already have the repo cloned:

./scripts/install.sh

The installer:

1. Checks prerequisites (git, jq, curl)
2. Clones the repo to ~/claude-homelab (or pulls if it exists)
3. Runs setup-creds.sh — creates ~/.claude-homelab/.env from .env.example with chmod 600
4. Runs setup-symlinks.sh — symlinks skills, agents, and commands into ~/.claude/
5. Runs verify.sh — confirms every symlink and required file is in place
6. Prints next steps

Credential Model

All credentials for every service live in a single file:

~/.claude-homelab/.env

This file is created from .env.example at install time and is never committed. Set it up interactively after install:

# Interactive wizard (preferred)
# Open Claude Code and run:
/homelab-core:setup

# Or configure manually
$EDITOR ~/.claude-homelab/.env

Security requirements:

• ~/.claude-homelab/.env must have chmod 600 (owner read/write only)
• Never commit .env — it is gitignored
• Never log credentials, even in debug mode
• Use .env.example as the template (tracked in git, placeholder values only)

All service scripts load credentials via scripts/load-env.sh:

source "${CLAUDE_PLUGIN_ROOT:-$HOME/claude-homelab}/scripts/load-env.sh"
load_env_file || exit 1
validate_env_vars "SERVICE_URL" "SERVICE_API_KEY"

Environment Variable Reference

Variables are grouped by service. Copy .env.example to ~/.claude-homelab/.env and replace placeholder values.

Media