Reflexo Release
Myriad-Dreamin/typst.ts
Guide Reflexo/typst.ts release preparation and operator handoffs.
Deploy LiveCodes to static servers, GitHub Pages, or Docker.
Install Self Hosting
$ npx skills add live-codes/livecodes --skill self-hosting -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install live-codes/livecodes self-hosting --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .claude/skills/self-hosting && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .claude/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hostingType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add live-codes/livecodes --skill self-hosting -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install live-codes/livecodes self-hosting --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .agents/skills/self-hosting && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .agents/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add live-codes/livecodes --skill self-hosting -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install live-codes/livecodes self-hosting --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .cursor/skills/self-hosting && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .cursor/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/live-codes/livecodes.git --path .agents/skills/livecodes/self-hosting--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add live-codes/livecodes --skill self-hosting -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install live-codes/livecodes self-hosting --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .gemini/skills/self-hosting && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .gemini/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install live-codes/livecodes self-hostingInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add live-codes/livecodes --skill self-hosting -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .github/skills/self-hosting && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .github/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add live-codes/livecodes --skill self-hosting -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install live-codes/livecodes self-hosting --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/live-codes/livecodes.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/livecodes/self-hosting .opencode/skills/self-hosting && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "self-hosting" agent skill from https://github.com/live-codes/livecodes/tree/develop/.agents/skills/livecodes/self-hosting into .opencode/skills/self-hosting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-hosting", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
self-hosting- GitHub stars
- 1.5k
- Token cost
- ~1.3k tokens
- SKILL.md length
- 302 words
- Files
- 1
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- MIT
At a glance
Deploy LiveCodes to static servers, GitHub Pages, or Docker.
- Works in 3 steps: Download from GitHub releases → Extract the build folder → Serve from any static host
- Tasks that involve Containers
- SKILL.md covers Deployment Options, Configure SDK for Self-Hosted…, Custom Build and Services, plus 3 more sections
- Calls npm, docker-compose and npx; reaches livecodes.io and v48.livecodes.io
What it does
Self Hosting is an agent skill from live-codes/livecodes. Deploy LiveCodes to static servers, GitHub Pages, or Docker. Configure SDK appUrl, BASEURL for subdirectories, and handle share/broadcast services. Load this skill when self-hosting LiveCodes or using a custom app URL.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Containers. It works with Docker and GitHub. The repository describes itself as: A Code Playground That Just Works! The licence is MIT.
When your agent uses it
- Tasks that involve Containers
Example prompts
- “/self-hosting”
Requirements
- Node.js
- Docker
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Download from GitHub releases
- Extract the build folder
- Serve from any static host
What it can do on your machine
Read from SKILL.md and the folder at commit f714b4b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npmdocker-composenpxgitfirebase
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
livecodes.iov48.livecodes.iocdn.jsdelivr.net
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Self Hosting loads about 1.3k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 302 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from live-codes/livecodes at commit f714b4b, republished under its MIT licence (© live-codes). 302 words, ~1,309 tokens.
Download SKILL.mdSave it as
.claude/skills/self-hosting/SKILL.md (or your agent's skills folder).- name
- self-hosting
- description
- Deploy LiveCodes to static servers, GitHub Pages, or Docker. Configure SDK appUrl, BASE_URL for subdirectories, and handle share/broadcast services. Load this skill when self-hosting LiveCodes or using a custom app URL.
- metadata.type
- composition
- metadata.library
- livecodes
- metadata.library_version
- 0.13.0
- requires
- sdk-embedding
- sources
- live-codes/livecodes:docs/docs/features/self-hosting.mdx
This skill requires sdk-embedding. Read it first for foundational concepts.
LiveCodes — Self-Host LiveCodes
LiveCodes runs entirely client-side. Host it on any static file server or CDN.
Deployment Options
Download Release
- Download from GitHub releases
- Extract the
buildfolder - Serve from any static host
# Files to serve
build/
├── index.html
├── livecodes/
│ ├── assets/
│ └── ...
└── docs/ (optional)Build from Source
git clone https://github.com/live-codes/livecodes.git
cd livecodes
npm install
npm run build # Build to build/ directory
npm run serve # Local preview at http://localhost:8080
npm run deploy # Build + deploy to GitHub PagesGitHub Pages (Built-in)
# Setup
npm install
npm run deploy # Deploys to gh-pages branchConfigure CNAME file for custom domain if needed.
Docker
docker-compose up -dDocker setup includes:
- HTTPS with auto-certificates
- Share service (short URLs)
- Broadcast server
- Open Graph meta tags
- Custom 404 page
# docker-compose.yml
# See: docs/docs/advanced/docker.mdx for customizationOther Static Hosts
- Cloudflare Pages: Connect repo,
npm run build, servebuild/ - Netlify: Connect repo,
npm run build, servebuild/ - Firebase Hosting:
firebase init hosting, deploybuild/
Configure SDK for Self-Hosted App
import { createPlayground } from 'livecodes';
createPlayground('#container', {
appUrl: 'https://playground.example.com',
template: 'react',
});The appUrl tells the SDK where to load the playground iframe from.
Custom Build
Subdirectory Hosting
By default, LiveCodes expects to be at the root of a domain. For subdirectories:
# Host at https://example.com/playground/
npx cross-env BASE_URL="/playground/" npm run buildThis sets <base href="/playground/"> and adjusts all asset paths.
Skip Building Docs
To link documentation to livecodes.io instead of building locally:
npx cross-env DOCS_BASE_URL=null npm run build:appDocs links will point to https://livecodes.io/docs/ instead of local docs.
Services
Self-hosted apps use fallback services:
| Service | Default Hosted | Self-Hosted |
|---|---|---|
| Share (short URLs) | dpaste.com (365 days) | dpaste.com or Docker setup |
| Broadcast | LiveCodes server | Docker setup required |
| GitHub Integration | LiveCodes OAuth | Your GitHub App |
Docker for Full Services
Docker setup provides all services:
docker-compose up -d
# Serves at https://livecodes.localhostSee docs/docs/advanced/docker.mdx for configuration.
Permanent URL for Stable Embeds
Use versioned URLs to prevent breaking changes:
// Version-specific URL (never changes)
createPlayground('#container', {
appUrl: 'https://v48.livecodes.io',
template: 'react',
});
// Pin SDK version
import { createPlayground } from 'livecodes@0.13.0';
// or
import { createPlayground } from 'https://cdn.jsdelivr.net/npm/livecodes@0.13.0';Permanent URLs format: https://v{VERSION}.livecodes.io
Common Mistakes
MEDIUM Not configuring BASE_URL for subdirectories
Wrong:
# Build default, serve at /playground/
npm run build
# Results in broken asset pathsCorrect:
# Set BASE_URL for subdirectory
npx cross-env BASE_URL="/playground/" npm run buildWithout BASE_URL, the app expects to be at root (/) and asset paths will be wrong.
Source: docs/docs/features/self-hosting.mdx — Custom Build section
MEDIUM Self-hosted share URLs expire
// dpaste.com deletes share URLs after 365 days
// For permanent self-hosted share:
// 1. Use Docker setup for own share service
// 2. Or use permanent URL pattern for embedsThe default dpaste.com service deletes shared URLs after one year. For permanent sharing, use Docker setup with your own share service.
Source: docs/docs/features/self-hosting.mdx — Services section
Examples
GitHub Pages
# Fork live-codes/livecodes
# Enable GitHub Pages in repo settings
npm install
npm run deploy
# Access at https://your-username.github.io/livecodes/Cloudflare Pages
# Build command: npm run build:app
# Output directory: build
# Environment: NODE_VERSION=18
# Access at https://your-subdomain.pages.dev/Docker VPS
git clone https://github.com/live-codes/livecodes.git
cd livecodes
docker-compose up -d
# Access at https://livecodes.localhost
# Configure domain in docker-compose.yml© live-codes, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/livecodes/self-hosting of live-codes/livecodes.
Open the folder on GitHubat commit f714b4b
Compare with similar skills
Self Hosting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Self Hosting this skilllive-codes/livecodes | 1.5k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Reflexo ReleaseMyriad-Dreamin/typst.ts | 1.2k | — | ~1.5k | Automated safety check: Pass | Apache-2.0 | |
| Opentagamplifthq/opentag | 1.4k | — | ~1.3k | Automated safety check: Notes | MIT | |
| 1panel App Builderarch3rPro/1Panel-Appstore | 213 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Releasebmeares/Meerschaum | 154 | — | ~1.1k | Automated safety check: Notes | Apache-2.0 | |
| Releasematrixorigin/memoria | 608 | — | ~494 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Opentag
amplifthq/opentag
Deploy or operate OpenTag's supported paired setup when a user needs to bootstrap the self-hosted Docker Compose Control Plane and Slack Source App, configure or pair a local ACP Runner with a…
1panel App Builder
arch3rPro/1Panel-Appstore
A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…
Release
bmeares/Meerschaum
Meerschaum release process — bump version, update changelog, stage dev→main PR, run CI, publish to PyPI, tag, GitHub release, build/push Docker images, rebuild docs on prod VPS.
Release
matrixorigin/memoria
Cut a Memoria release. An agent skill from matrixorigin/memoria.
Reproduce Issue
nrwl/nx
The single skill for reproducing an nx issue. An agent skill from nrwl/nx.
More from live-codes/livecodes
All 15 skills in this repoLanguage Support
live-codes/livecodes
Work with 90+ supported languages, compilers, CSS processors, and WASM-compiled languages for markup, style, and script editors.
Configuration
live-codes/livecodes
Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings.
Display Modes
live-codes/livecodes
Configure how the playground is displayed: full, focus, simple, lite, editor, codeblock, and result modes.
Framework Wrappers
live-codes/livecodes
Use SDK with React, Vue, Svelte, Solid, Preact, and Web Components.
Getting Started
live-codes/livecodes
Quick start for standalone app at livecodes.io, embedding playgrounds with CDN or npm, and self-hosting basics.
Gh Action
live-codes/livecodes
Use the "Preview in LiveCodes" GitHub Action to generate preview playground links for pull request code changes.
Related
Categories
Questions about Self Hosting
What does Self Hosting do?
Deploy LiveCodes to static servers, GitHub Pages, or Docker. Self Hosting is an agent skill from live-codes/livecodes. Deploy LiveCodes to static servers, GitHub Pages, or Docker.
When should I use Self Hosting?
Self Hosting fits situations like: tasks that involve Containers.
How do I install Self Hosting in Claude Code?
Run `npx skills add live-codes/livecodes --skill self-hosting -a claude-code`. Or copy the skill folder (.agents/skills/livecodes/self-hosting in live-codes/livecodes) into .claude/skills/self-hosting in your project. Claude Code loads it when a task matches its description.
How do I install Self Hosting in Codex?
Run `npx skills add live-codes/livecodes --skill self-hosting -a codex`. Or copy the skill folder (.agents/skills/livecodes/self-hosting in live-codes/livecodes) into .agents/skills/self-hosting in your project. Codex loads it when a task matches its description.
Can I use Self Hosting in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add live-codes/livecodes --skill self-hosting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-hosting, .gemini/skills/self-hosting, .github/skills/self-hosting and .opencode/skills/self-hosting in your project.
What does Self Hosting need to run?
Going by SKILL.md and its folder, Self Hosting needs the command-line tools its instructions call (npm, docker-compose, npx, git and firebase). Our summary lists: Node.js; Docker.
Does Self Hosting access the network?
SKILL.md names 3 domains. In commands or code: livecodes.io, v48.livecodes.io and cdn.jsdelivr.net; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Is Self Hosting safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Self Hosting use?
Self Hosting is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Self Hosting use?
About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Self Hosting?
Skills that share tags, products or a category with Self Hosting: Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars), Opentag (amplifthq/opentag, 1.4k stars), 1panel App Builder (arch3rPro/1Panel-Appstore, 213 stars) and Release (bmeares/Meerschaum, 154 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Self Hosting?
live-codes (a GitHub organization) maintains it in live-codes/livecodes, which has 1,514 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.
Source: live-codes/livecodes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.