Vibeleaderboard
Index / agent
Visit github.com
Category
AI Agents
Rank
No. 1848Tools index
Pricing
Open Source
Type
AGENT
Builder
@Alderik_
GitHub
43 stars
Date

About

A Claude Code agent skill that provisions and operates a web app on one hardened Ubuntu VPS instead of a multi-service PaaS, wiring up Node.js, SQLite, Caddy for TLS, systemd and backups on a single box. It supports deploying from a local machine or developing directly on the server with Claude Code held open in a tmux session, reachable over Tailscale. Optional steps cover Cloudflare domain setup and Stripe subscription billing.

What it does

An opinionated operations playbook for small Node applications. It guides Claude through two modes: build remotely from a local checkout, or edit production directly through a persistent terminal session. The stack combines SQLite, Caddy, systemd, private SSH access, offsite replication, optional edge routing, and subscription billing.

Why it's ranked here

The repository turns a coherent single-server philosophy into editable scripts and unusually detailed operational guidance. It handles native SQLite builds, secret placement, service recovery, SSH lockout prevention, domains, and payments. The verdict is mixed-positive because its narrow assumptions create clarity, while direct production development and broad passwordless sudo demand experienced judgment.

What's good

The deployment builds native dependencies on the server, keeps database files outside the replaced application tree, and verifies service health after restart. Provisioning refuses to disable password login without an authorized key. The private-network lockdown requires explicit confirmation before removing public SSH access. Troubleshooting covers database contention, missing native bindings, certificate failures, permissions, restart loops, and recovery from lockout.

Tradeoffs

This is a template collection, not a turnkey platform. Users must inspect and edit configuration before execution. It centers Ubuntu, Node, Next.js, SQLite, Caddy, systemd, Tailscale, and specific cloud workflows. The production-editing path removes a normal development boundary. Provisioning grants the deploy user unrestricted passwordless sudo. Single-box operation also concentrates application and database availability, making tested offsite restoration essential.

How to use it well

Use it for a solo or small-team Node product whose traffic and data fit one vertically scaled server. Choose remote deployment when staging boundaries matter. Choose on-server development only with disciplined version control and working backups. It earns a place as a concrete self-hosting runbook, but it does not cover clustered availability, distributed databases, container orchestration, or general multi-service architecture.

Technical notes+

SKILL.md routes users between host-only and on-VPS workflows. scripts/provision.sh targets Ubuntu 24.04, creates a non-root service account, writes Caddy and systemd configuration, stores environment values under /etc/<app>/env, and grants unrestricted passwordless sudo. scripts/deploy.sh uses rsync, performs npm ci and the build remotely, copies the better-sqlite3 native binding, swaps standalone output, restarts systemd, and checks HTTPS. One caveat: its health-check domain is derived from SSH_HOST, so a tailnet IP or non-public SSH hostname may not match the configured public domain. scripts/lock-down-tailscale.sh includes connection checks and interactive confirmation. scripts/setup-stripe.sh protects the key through a mode-restricted file, but parses Stripe CLI JSON with grep and cut, which is brittle compared with structured parsing. references/troubleshooting.md documents concrete recovery paths.

Observed

License
MIT License
Primary implementation
Bash script templates with Markdown operational documentation
Install surface
Copied into a Claude Code project-level or user-level skills directory for automatic discovery
Interface
Claude Code Agent Skill supported by editable command-line scripts
Server platform
Fresh Ubuntu 24.04 LTS VPS, with Hetzner and DigitalOcean workflows documented
Application scope
Next.js standalone or another Node application using a single self-contained process
Repository structure
Skill definition, shell scripts, reference guides, README, and license; no test directory appears in the provided tree

Read from README.md, LICENSE, SKILL.md, scripts/deploy.sh, scripts/provision.sh, scripts/setup-stripe.sh, references/architecture.md, scripts/setup-dev-on-vps.sh, references/develop-on-vps.md, references/monetize-stripe.md, references/troubleshooting.md, scripts/lock-down-tailscale.sh, references/domain-cloudflare.md, references/provision-hetzner.md.

Tags

claude-codeagent-skillvpsdeploymentself-hostingdevops

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.