Agent skill · Security

krypton-vps-codex-app

Set up, harden, audit, or explain a Linux VPS as a Codex App SSH host for Krypton-style agent workflows. Use when the user wants to move Codex or Claude Code work from a local Mac to a VPS, connect Codex App to an SSH host, configure Ubuntu 24.04/devbox tools, clone a repo remotely, run Codex/Claude/tmux/cmux on the VPS, forward ports for localhost testing, or create repeatable founder/builder setup instructions with proof checks.

jturntdevgithub.com/jturntdevGitHub ↗
codexclaude-codeships scriptsMIT
Install
npx skills add jturntdev/krypton --skill krypton-vps-codex-app --agent codex

Same command for any agent — swap --agent for claude-code, cursor, copilot.

Facts
Files in the skill folder: 4
SKILL.md size: 13 KB
Bundled scripts: yes
Path: skills/krypton-vps-codex-app/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 124
Language: Shell

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Krypton VPS Codex App ## Overview Turn a Linux VPS into the machine that does the work while the operator's Mac only displays and controls it. The target result is a working Codex App SSH project where commands, edits, builds, tests, tmux/cmux sessions, dev servers, and agent runs happen on the VPS. Do not describe this as installing Codex App on the VPS. Codex App stays on the operator's Mac or Windows machine; the VPS needs the Codex CLI and repo toolchain so the app can start the remote Codex app server through SSH. Use the current OpenAI Codex docs for Codex App specifics when facts may have changed. The durable setup facts this skill relies on are: - Codex App can add projects from an SSH host. - Codex reads concrete SSH aliases from `~/.ssh/config`. - Remote project threads run commands and edit files on the remote host. - The remote host provides the repo files, credentials, tools, skills, MCP setup, browser/computer-use setup, and sandbox/approval behavior. - The remote `codex` command must be available on the remote user's login-shell `PATH`. ## Responsibility Split Codex can prepare commands, inspect SSH config, audit the VPS, bootstrap tools over SSH when it has access

What's inside
Steps it walks through
  1. Overview
  2. Responsibility Split
  3. First Response
  4. Setup Workflow
  5. 1. Host And Security Preflight
  6. 2. Mac SSH Config
  7. 3. VPS Tooling
  8. 4. Codex On The VPS
  9. 5. Repo And Project
  10. 6. Local Config And Secrets
  11. 7. Codex App Connection
  12. 8. Port Forwarding
  13. 9. cmux And tmux
  14. Audit Script
Ships with 3 files
  • agents/openai.yaml
  • references/setup-runbook.md
  • scripts/audit-vps-codex-app.sh
Commands it runs
ssh krypton-vps
command -v codex
codex --version
codex login --device-auth
gh auth login
gh auth status
gh repo clone ORG/REPO ~/src/REPO
ssh-keygen -t ed25519 -C "krypton-vps" -f ~/.ssh/github-krypton-vps
cat ~/.ssh/github-krypton-vps.pub
ssh -T git@github.com
More from krypton
All skills →
About this skill
What does the krypton-vps-codex-app skill do?

Set up, harden, audit, or explain a Linux VPS as a Codex App SSH host for Krypton-style agent workflows. Use when the user wants to move Codex or Claude Code work from a local Mac to a VPS, connect Codex App to an SSH host, configure Ubuntu 24.04/devbox tools, clone a repo remotely, run Codex/Claude/tmux/cmux on the VPS, forward ports for localhost testing, or create repeatable founder/builder setup instructions with proof checks.

How do I install it?

Run `npx skills add jturntdev/krypton --skill krypton-vps-codex-app --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From jturntdev/krypton, a repository with 124 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going