vps

An orchestration guide for a VPS Control Room project, which is a tool for managing servers and deployments from one project. It documents the project structure, build commands, environment variables, and deployment process.

In plain words
What is it for?
Use it to build the frontend and agent, run the production deployment script, check required environment variables, and delegate deployment work to the listed coding agent.
Why use it?
It gives an agent the project-specific information needed to build and deploy the application without searching through the repository. It also records an important runtime detail: the daemon must use Node.js 22 rather than Bun.

Agent for Codex

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.

agentmods
npx agentmods add agents/rahmanef63/control-room/vps
Clone the repo
git clone --depth 1 https://github.com/rahmanef63/control-room

Made for: Codex.

Per session 36 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 371 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00036 $0.00371
Opus 5 $0.00018 $0.00186
Sonnet 5 $0.00007 $0.00074
Haiku 4.5 $0.00004 $0.00037

Measured 2d ago against content hash e5e70d324631, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

vps scanned grade A with 0 findings 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 2d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.codex/agents/vps.md · 49 lines

What it actually says

VPS Control Room — Codex Orchestrator

Project Layout

frontend/   Next.js 15 + Tailwind v4 + shadcn/ui
convex/     Self-hosted Convex (7 tables: events, audit_log, agent_status,
            system_snapshot, alerts, commands, app_status)
agent/      TypeScript, built with bun but the daemon RUNS ON NODE 22
            (node-pty emits no data under Bun → blank terminals)
skills/     si-coder deploy skill

Build Commands

bun run --cwd frontend build        # frontend (bun --bun next build)
bun run --cwd agent build           # agent (tsc)
bash scripts/deploy.sh              # full production deploy

Codex YOLO Flags

codex --yolo        # no sandbox, no approvals (--dangerously-bypass-approvals-and-sandbox)
codex --full-auto   # sandboxed auto-approve (safer)
codex --approval-policy on-request  # prompt only when needed

Deploy New Project

Delegate to si-coder agent or run directly:

node ~/projects/vps-control-room/skills/si-coder/scripts/deploy.js \
  "$DOKPLOY_API_URL" "$DOKPLOY_API_KEY" "<project>" "<app>" "$GITHUB_TOKEN" "<domain>"

Required Env Vars

DOKPLOY_API_URL   DOKPLOY_API_KEY   GITHUB_TOKEN   HOSTINGER_API_TOKEN (optional)
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. 2d ago First seen · 49 lines · 36 tokens per session scan A e5e70d324631

Subscribe to this mod's changes

vps is an agent published in the GitHub repository rahmanef63/control-room (19 stars, last pushed 2d ago), licensed MIT. It adds 36 tokens to every session and 371 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

omd-slop-auditor

실제 제품 route와 코드를 함께 읽어 context-free UI/copy pattern cluster를 rule ID·line ref·route evidence로 진단한다. AI slop, 일반 접근성·품질 오류, 사용자 취향을 분리하고 최소 수정과 동일 route 재검증 조건을 제시하는 read-mostly specialist.

kwakseongjae/oh-my-design · 76 tokens

omd-designer-review

Visual + brand consistency reviewer. Audits HTML/MD/JSX against the brand DESIGN.md across typography, color budget, radius scale, component states, mobile responsiveness, spacing. Outputs BLOCK / WARN / FYI with line refs. Read-only advisory — never modifies artifacts.

kwakseongjae/oh-my-design · 61 tokens

stitch-kit

Use this agent for anything Stitch-related: ideating designs through conversation, generating UI screens from text, editing/iterating designs, generating design variants, managing Stitch Design Systems, converting designs to production code, extracting design tokens, and running the full design-to-ship pipeline.…

gabelul/stitch-kit · 237 tokens

flutter-engineer

Use this agent when building Flutter applications with Dart 3.11, Riverpod 3, GoRouter 17, Material 3, Freezed 3, Dio 5, and all 6 platform targets (iOS, Android, Web, macOS, Windows, Linux).

altmemy/claude-code-templates · 62 tokens

accessibility-specialist

Use this agent when implementing comprehensive accessibility solutions, conducting WCAG 2.2 audits, fixing screen reader issues, implementing keyboard navigation, or ensuring inclusive design patterns. Invoke for focus management in Next.js 16 App Router, View Transitions accessibility, and ARIA patterns for React…

altmemy/claude-code-templates · 67 tokens

frontend-engineer

Use this agent when building modern frontend applications with React 19.2, Next.js 16 App Router, TypeScript 6, and Tailwind CSS v4. Invoke for component architecture, data fetching, Cache Components, proxy.ts, Server Components, View Transitions, and full-stack frontend patterns.

altmemy/claude-code-templates · 65 tokens