homerail-shared

homerail-shared is a skill for Codex from xiaotianfotos/homerail. It costs 63 tokens per session (1,444 once invoked), scanned A, original, MIT.

A shared rule set for operating HomeRail, a local system that runs AI-agent workflows through Manager, Node, and Worker services. It covers service roles, settings, secrets, Docker networking, updates, and safe commands.

In plain words
What is it for?
Use it when installing, configuring, upgrading, troubleshooting, or running HomeRail, especially when setting environment values, storing secrets, starting services, or sharing workspace data between workers.
Why use it?
It keeps installation and troubleshooting consistent across HomeRail components. It also prevents credentials from being written into project files and clarifies how the local services and worker containers connect.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: mentions Claude Code.

Good fit Use it when installing, configuring, upgrading, troubleshooting, or running HomeRail, especially when setting environment values, storing secrets, starting services, or sharing workspace data between workers.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xiaotianfotos/homerail/homerail-shared
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xiaotianfotos/homerail --skill homerail-shared
Clone the repo
git clone --depth 1 https://github.com/xiaotianfotos/homerail

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for homerail-shared

README.md
[![agentmods](https://agentmods.dev/badge/skills/xiaotianfotos/homerail/homerail-shared/github.svg)](https://agentmods.dev/skills/xiaotianfotos/homerail/homerail-shared)
Your own site
<a href="https://agentmods.dev/skills/xiaotianfotos/homerail/homerail-shared"><img src="https://agentmods.dev/badge/skills/xiaotianfotos/homerail/homerail-shared/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for homerail-shared

Your own site · 80×15
<a href="https://agentmods.dev/skills/xiaotianfotos/homerail/homerail-shared"><img src="https://agentmods.dev/badge/skills/xiaotianfotos/homerail/homerail-shared.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,444 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00063 $0.01444
Opus 5 $0.00032 $0.00722
Sonnet 5 $0.00013 $0.00289
Haiku 4.5 $0.00006 $0.00144

Measured 12d ago against content hash 554b779a0ee2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

homerail-shared scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Do not start service diagnosis with raw process probes or source spelunking.** Run `hr doctor` (readiness) and `hr runtime status` (live state) first; they report manager/node/worker/model state. Use `ps`, `lsof`, di
skills/homerail-shared/SKILL.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

HomeRail Shared

Core Rules

Use these rules with all HomeRail skills.

  • Treat this release as a local-source install. Do not assume npm packages or public GitHub URLs exist yet.

  • Prefer placeholders such as <local-homerail-repo> and /path/to/HomeRail in user-facing instructions.

  • Keep provider and integration secrets in the Manager encrypted secret store through CLI/UI configuration; never write API keys, tokens, or passwords into repo files, skill files, DAG templates, commits, or issue text.

  • Use one shared HOMERAIL_HOME for Manager and Node. Default is $HOME/.homerail.

  • Prefer hr config for local runtime settings and hr start to start Manager and Node together.

  • Manager and Node run as local services. Manager is not expected to run inside the Worker Docker image.

  • Node provisions Worker containers. Workers for one run should share ${HOMERAIL_HOME}/workspace/<run_id>.

  • Local service ports (use this table and the CLI before falling back to low-level process probes):

    Port Role Default URL Notes
    19191 Manager (HTTP + WS, what DAGs and the CLI talk to) http://localhost:19191 This is the only port a DAG run / CLI hits. Bind via HOMERAIL_MANAGER_HOST / manager.host / hr start --host; public access via HOMERAIL_MANAGER_PUBLIC_URL / hr start --public-url.
    19192 Agent UI (HTTPS, browser) https://localhost:19192 Browser-only. Do NOT send DAG/CLI traffic here. Config via HOMERAIL_UI_HOST / HOMERAIL_UI_PORT / ui.host / ui.port.
    19193 Agent UI HTTP fallback http://localhost:19193 Fallback when HTTPS port is taken. Config via HOMERAIL_UI_HTTP_PORT / ui.httpPort.

    The Manager port is 19191, not 19192. 19192 is the Agent UI. Mixing these up is the most common startup mistake.

  • For hr start --ui --public without explicit public URLs, Agent UI should bind and advertise the detected machine IP with HTTPS, and the browser should use same-origin Manager API/WS proxying for the HTTPS UI. Use HOMERAIL_PUBLIC_HOST only when automatic machine IP detection picks the wrong interface.

  • For reverse-proxied public access, prefer explicit HTTPS/WSS public URLs through HOMERAIL_MANAGER_PUBLIC_URL / HOMERAIL_UI_PUBLIC_URL or --public-url / --ui-public-url.

  • Do not hardcode Docker bridge addresses. Use Docker host.docker.internal / host-gateway support or explicit operator-provided callback settings.

Read the full file on GitHub · 92 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 92 lines · 63 tokens per session scan A 554b779a0ee2

Subscribe to this mod's changes

homerail-shared is a skill published in the GitHub repository xiaotianfotos/homerail (951 stars, last pushed today), licensed MIT. It adds 63 tokens to every session and 1,444 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

deploy-docker-compose

Run the Omnigent server as a Docker compose stack (server + Postgres) on any Docker host — your laptop, a VPS, EC2 by hand, or as the base layer of any container-platform deploy. Invoke when the user wants to build the image, bring up the compose stack, debug the stack on a host they already have, or extend the stack…

omnigent-ai/omnigent · 84 tokens

compute-env-setup

Set up a reproducible Feynman compute environment for research jobs. Use when a task needs Python/R packages, GPU libraries, containers, Modal, SSH, caches, or managed model runtime setup.

companion-inc/feynman · 45 tokens

securing-kubernetes-on-cloud

This skill covers hardening managed Kubernetes clusters on EKS, AKS, and GKE by implementing Pod Security Standards, network policies, workload identity, RBAC scoping, image admission controls, and runtime security monitoring. It addresses cloud-specific security features including IRSA for EKS, Workload Identity for…

xalgorix/xalgorix · 80 tokens

detecting-privilege-escalation-in-kubernetes-pods

Detect and prevent privilege escalation in Kubernetes pods by monitoring security contexts, capabilities, and syscall patterns with Falco and OPA policies.

xalgorix/xalgorix · 40 tokens

implementing-rbac-hardening-for-kubernetes

Harden Kubernetes Role-Based Access Control by implementing least-privilege policies, auditing role bindings, eliminating cluster-admin sprawl, and integrating external identity providers.

xalgorix/xalgorix · 41 tokens

docker-socket-mount

Docker / containerd socket mounted into a container → host RCE. Common in CI runners, GitOps controllers (ArgoCD, Flux), and 'Docker-in-Docker' setups. Single-command escape via docker run --rm --privileged -v /:/host alpine chroot /host.

PurpleAILAB/Decepticon · 67 tokens