gemini-homelab

# 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

```bash
/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

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

Or, if you already have the repo cloned:

```bash
./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:

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

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

Security requirements:

- `~/.gemini-homelab/.env` mus