# appgarden

Manages web application deployments on remote servers via SSH using the AppGarden CLI. Configures services, inspects logs, and exposes local ports through tunnels.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 509 installs
- Author: lukastk
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lukastk/appgarden/tree/HEAD/SKILL.md
- Updated: 2026-09-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/appgarden

## What it does

This skill teaches coding assistants how to control the `appgarden` command-line utility. The tool runs agentless over SSH. It provisions remote hosts, creates configurations for Caddy, Docker, or systemd, and tracks deployment records in `/srv/appgarden`. The assistant executes safe read-only queries like `apps status` and `server ping` automatically, but pauses to request permission before running destructive operations, modifying firewall rules, or stopping containers.

Multiple deployment roots can exist on a single machine under custom `app_root` locations. Because systemd units and Docker containers use a shared host prefix `appgarden-<name>`, application names must remain unique across the entire machine. Network port assignments are coordinated across all gardens through a central host registry at `/var/lib/appgarden/ports.json` to prevent port collisions.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add lukastk/appgarden --skill appgarden -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/appgarden/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/appgarden/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lukastk/appgarden --skill appgarden -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/appgarden/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lukastk/appgarden --skill appgarden -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/appgarden/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lukastk/appgarden appgarden
```

2. **Manually: put the files in place**
- File: `.github/skills/appgarden/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lukastk/appgarden --skill appgarden -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lukastk/appgarden
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/appgarden/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add lukastk/appgarden --skill appgarden -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/lukastk/appgarden/tree/HEAD/SKILL.md

## When to use it
- deploy web services to remote hosts via SSH
- generate and validate `appgarden.toml` deployment profiles
- inspect remote application logs, health status, and metadata
- expose local development ports through public tunnels

## Example prompts
- Generate an appgarden.toml setup for a containerized service on myserver
- Inspect runtime logs and deployment status for myapp
- Open an appgarden tunnel to expose local port 3000 through myserver

## Similar
- [n8n-self-hosting](https://affpapa.org/en/nevibecode/skills/n8n-self-hosting.md) — skill · 2400 installs
- [podman](https://affpapa.org/en/nevibecode/skills/podman.md) — skill · 463 installs
- [tunnel-doctor](https://affpapa.org/en/nevibecode/skills/tunnel-doctor.md) — skill · 741 installs
- [windows-vm](https://affpapa.org/en/nevibecode/skills/windows-vm.md) — skill · 285 installs
- [runpod-templates](https://affpapa.org/en/nevibecode/skills/runpod-templates.md) — skill · 12100 installs
- [langgraph-cli](https://affpapa.org/en/nevibecode/skills/langgraph-cli.md) — skill · 10000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
