Comprehensive Agents, Commands, Hooks, and Skills for homelab service management - media automation, infrastructure monitoring, document management, and more

Gemini 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

gemini-homelab serves three roles at once:

• The homelab-core plugin published through the Gemini 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 ~/.gemini/ or ~/.gemini/plugins/cache/ directly.

Installation

Gemini marketplace

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

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

Bash / symlink install

curl -sSL https://raw.githubusercontent.com/jmagar/gemini-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 ~/gemini-homelab (or pulls if it exists)
3. Runs setup-creds.sh — creates ~/.gemini-homelab/.env from .env.example with chmod 600
4. Runs setup-symlinks.sh — symlinks skills, agents, and commands into ~/.gemini/
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:

~/.gemini-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 ~/.gemini-homelab/.env

Security requirements:

• ~/.gemini-homelab/.env mus