How do I install the Deploy Webicached skill?

Run npx skillmds@latest add webinstall/deploy-webicached in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Deploy Webicached safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deploy Webicached?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deploy Webicached free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deploy Webicached?

webinstall (@webinstall) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deploy Webicached by webinstall — Agent Skill

Name: Deploy Webicached
Author: webinstall

File contents

One-step deploy

./scripts/deploy-webicached.sh beta.webi.sh

Builds with version ldflags, stops service, uploads, syncs conf, starts, verifies.

Manual steps (if needed)

Build

VERSION="$(git describe --tags --always)"
COMMIT="$(git rev-parse --short HEAD)"
DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
GOOS=linux GOARCH=amd64 GOAMD64=v2 go build \
  -ldflags "-X main.version=${VERSION} -X main.commit=${COMMIT} -X main.date=${DATE}" \
  -o agents/tmp/webicached ./cmd/webicached

MUST: Build from the ref-webi-go worktree (or branch containing cmd/webicached).

Deploy

ssh beta.webi.sh "serviceman stop webicached"
scp agents/tmp/webicached beta.webi.sh:~/bin/webicached

MUST: Stop service before scp — Linux refuses to overwrite a running binary.

Sync releases.conf

rsync -av --include='*/' --include='releases.conf' --exclude='*' \
  ./ beta.webi.sh:~/srv/beta.webinstall.dev/installers/

MUST: Run from the worktree root. The server has no checkout of this branch — conf files must be synced explicitly.

Start

ssh beta.webi.sh "serviceman start webicached"

Verify

ssh beta.webi.sh "sleep 5 && serviceman logs webicached"

Expected: "batch: N stale, refreshing 20" or "all packages fresh, sleeping 9s"

Smoke test

ssh beta.webi.sh "curl -sSf http://localhost:3080/api/releases/bat.json | head -c 100"
ssh beta.webi.sh "curl -sSf -A 'curl/7.81.0 Linux x86_64' http://localhost:3080/api/installers/bat.sh | head -3"

Expected: JSON array with release objects; shell script with PKG_NAME='bat'.

Service management

serviceman status webicached
serviceman restart webicached
serviceman logs webicached

Server layout

Path	Purpose
`~/bin/webicached`	Binary
`~/srv/beta.webinstall.dev/installers/`	Conf dir (releases.conf files)
`~/.cache/webi/legacy/`	Cache output (fsstore, legacy JSON format)
`~/.cache/webi/raw/`	Raw upstream API responses
`~/srv/beta.webinstall.dev/.env.secret`	GITHUB_TOKEN
`/etc/systemd/system/webicached.service`	Service unit (created by serviceman)

Flags reference

Flag	Default	Purpose
`--conf`	`.`	Dir with `{pkg}/releases.conf` files
`--legacy`	`~/.cache/webi/legacy`	Legacy cache output directory
`--raw`	`~/.cache/webi/raw`	Raw upstream response cache
`--token`	`$GITHUB_TOKEN`	GitHub API token
`--interval`	`9s`	Delay between package fetches in a batch
`--once`	false	Run once then exit
`--eager`	false	Fetch all on startup (not staleness-based)
`--shallow`	false	Only first page of releases
`--no-fetch`	false	Classify from rawcache only
`--page-delay`	`2s`	Delay between paginated API pages

One-shot refresh (specific packages)

ssh beta.webi.sh ". ~/srv/beta.webinstall.dev/.env.secret && ~/bin/webicached \
  --conf ~/srv/beta.webinstall.dev/installers/ \
  --raw ~/.cache/webi/raw \
  --once bat goreleaser"

---name: deploy-webicacheddescription: Deploy webicached binary to beta.webi.sh. Use when building, uploading, or restarting the cache daemon. Covers cross-compile, conf sync, service management.---## One-step deploy```sh./scripts/deploy-webicached.sh beta.webi.sh```Builds with version ldflags, stops service, uploads, syncs conf, starts, verifies.## Manual steps (if needed)### Build```shVERSION="$(git describe --tags --always)"COMMIT="$(git rev-parse --short HEAD)"DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)"GOOS=linux GOARCH=amd64 GOAMD64=v2 go build \ -ldflags "-X main.version=${VERSION} -X main.commit=${COMMIT} -X main.date=${DATE}" \ -o agents/tmp/webicached ./cmd/webicached```MUST: Build from the `ref-webi-go` worktree (or branch containing `cmd/webicached`).### Deploy```shssh beta.webi.sh "serviceman stop webicached"scp agents/tmp/webicached beta.webi.sh:~/bin/webicached```MUST: Stop service before scp — Linux refuses to overwrite a running binary.### Sync releases.conf```shrsync -av --include='*/' --include='releases.conf' --exclude='*' \ ./ beta.webi.sh:~/srv/beta.webinstall.dev/installers/```MUST: Run from the worktree root. The server has no checkout of this branch — conf files must be synced explicitly.### Start```shssh beta.webi.sh "serviceman start webicached"```### Verify```shssh beta.webi.sh "sleep 5 && serviceman logs webicached"```Expected: "batch: N stale, refreshing 20" or "all packages fresh, sleeping 9s"## Smoke test```shssh beta.webi.sh "curl -sSf http://localhost:3080/api/releases/bat.json | head -c 100"ssh beta.webi.sh "curl -sSf -A 'curl/7.81.0 Linux x86_64' http://localhost:3080/api/installers/bat.sh | head -3"```Expected: JSON array with release objects; shell script with `PKG_NAME='bat'`.## Service management```shserviceman status webicachedserviceman restart webicachedserviceman logs webicached```## Server layout| Path | Purpose ||------|---------|| `~/bin/webicached` | Binary || `~/srv/beta.webinstall.dev/installers/` | Conf dir (releases.conf files) || `~/.cache/webi/legacy/` | Cache output (fsstore, legacy JSON format) || `~/.cache/webi/raw/` | Raw upstream API responses || `~/srv/beta.webinstall.dev/.env.secret` | GITHUB_TOKEN || `/etc/systemd/system/webicached.service` | Service unit (created by serviceman) |## Flags reference| Flag | Default | Purpose ||------|---------|---------|| `--conf` | `.` | Dir with `{pkg}/releases.conf` files || `--legacy` | `~/.cache/webi/legacy` | Legacy cache output directory || `--raw` | `~/.cache/webi/raw` | Raw upstream response cache || `--token` | `$GITHUB_TOKEN` | GitHub API token || `--interval` | `9s` | Delay between package fetches in a batch || `--once` | false | Run once then exit || `--eager` | false | Fetch all on startup (not staleness-based) || `--shallow` | false | Only first page of releases || `--no-fetch` | false | Classify from rawcache only || `--page-delay` | `2s` | Delay between paginated API pages |## One-shot refresh (specific packages)```shssh beta.webi.sh ". ~/srv/beta.webinstall.dev/.env.secret && ~/bin/webicached \ --conf ~/srv/beta.webinstall.dev/installers/ \ --raw ~/.cache/webi/raw \ --once bat goreleaser"```

Frequently asked questions

Deploy Webicached