Agent skill

Runtime Remsh

by z80dev in z80dev/lemon

Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

MITAuto-check passedBackend & APIs

Install Runtime Remsh

skills CLI
$ npx skills add z80dev/lemon --skill runtime-remsh -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install z80dev/lemon runtime-remsh --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/z80dev/lemon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/lemon_skills/priv/builtin_skills/runtime-remsh .claude/skills/runtime-remsh && rm -rf skills-src

Use ~/.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/

Facts

Skill name
runtime-remsh
GitHub stars
132
Token cost
~819 tokens
SKILL.md length
265 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

  • Backend & APIs work in your project
  • SKILL.md covers Trigger, Preconditions, Quickstart (local gateway) and Recompile changed code in the…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Runtime Remsh is an agent skill from z80dev/lemon. Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

Its SKILL.md is about 820 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 Backend & APIs. It works with Elixir. The repository describes itself as: BEAM-native platform for LLM agents: OTP-supervised per-run processes, pluggable engines and channels, contract-tested extension points, and a deterministic multi-agent sim arena. The licence is MIT.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/runtime-remsh”

What it can do on your machine

Read from SKILL.md and the folder at commit 899e215. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and elixir).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Runtime Remsh loads about 819 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 265 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~819

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 z80dev/lemon at commit 899e215, republished under its MIT licence (© z80dev). 265 words, ~819 tokens.

Download SKILL.mdSave it as .claude/skills/runtime-remsh/SKILL.md (or your agent's skills folder).
name
runtime-remsh
description
Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

runtime-remsh

Use this skill when the user asks to connect to a running Lemon instance, recompile changed Elixir code without restarting, or run Elixir inside the live runtime.

Trigger

Use this skill for requests like:

  • "connect to the running gateway"
  • "attach to lemon and run recompile()"
  • "execute this Elixir in the live runtime"
  • "run rpc-eval against the node"

Preconditions

  • The target process must be started as a distributed node (--sname or --name) with a cookie.
  • The attaching shell must use the same naming mode and same cookie.
  • For ./bin/lemon-gateway, do not use --no-distribution.

Quickstart (local gateway)

Start gateway (terminal 1):

bash
./bin/lemon-gateway

Attach from another terminal (short-name default):

bash
iex --sname lemon_attach --cookie lemon_gateway_dev_cookie --remsh "lemon_gateway@$(hostname -s)"

If gateway was started with explicit settings, use those exact values:

bash
./bin/lemon-gateway --sname lemon_gateway --cookie "change-me"
iex --sname lemon_attach --cookie "change-me" --remsh "lemon_gateway@$(hostname -s)"

For long-name mode:

bash
./bin/lemon-gateway --name lemon_gateway@my-host.example.com --cookie "change-me"
iex --name lemon_attach@my-host.example.com --cookie "change-me" --remsh lemon_gateway@my-host.example.com

Tip: ./bin/lemon-gateway prints the exact Remote shell target to use.

Recompile changed code in the live runtime

Inside attached IEx:

elixir
recompile()

Useful follow-up checks:

elixir
node()
Application.started_applications() |> Enum.map(&elem(&1, 0))

If needed, force reload a module:

elixir
r(LemonGateway.Run)

Execute arbitrary Elixir code in the live runtime

Interactive (--remsh) examples:

elixir
LemonGateway.Config.get()
LemonGateway.Config.get(:default_engine)

Non-interactive one-off (--rpc-eval) example:

bash
elixir --sname lemon_probe --cookie lemon_gateway_dev_cookie --rpc-eval "lemon_gateway@$(hostname -s)" "IO.inspect(LemonGateway.Config.get(:default_engine))"

Long-name one-off:

bash
elixir --name lemon_probe@my-host.example.com --cookie "change-me" --rpc-eval "lemon_gateway@my-host.example.com" "IO.puts(node())"

Troubleshooting

  • nodedown or timeout:
    • Ensure both sides use short names (--sname) or both use long names (--name).
    • Confirm the exact target node name from gateway startup logs.
  • Invalid challenge reply:
    • Cookie mismatch. Use the same cookie on launcher and attach command.
  • Attach works but app calls fail:
    • Target process may have exited after startup; check gateway logs.
  • Verify registration with EPMD:
bash
epmd -names

Safety

  • Default to read-only inspection unless the user asked to mutate state.
  • Call out risky runtime actions before executing them (state mutation, process termination, file/network side effects).
  • Prefer --rpc-eval for small one-off checks and --remsh for multi-step debugging.

© z80dev, 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 apps/lemon_skills/priv/builtin_skills/runtime-remsh of z80dev/lemon.

Open the folder on GitHubat commit 899e215

Compare with similar skills

Runtime Remsh 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.

Runtime Remsh compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Runtime Remsh this skillz80dev/lemon132—~819Automated safety check: PassMIT
Ecto Persistence Patternsgeorgeguimaraes/elixir-agent-tools184—~1.2kAutomated safety check: PassApache-2.0
Oban Background Jobsgeorgeguimaraes/elixir-agent-tools184—~2.2kAutomated safety check: PassApache-2.0
Elixir OTP Concurrencygeorgeguimaraes/elixir-agent-tools184—~1.2kAutomated safety check: PassApache-2.0
Phoenix LiveView Patternsgeorgeguimaraes/elixir-agent-tools184—~1.3kAutomated safety check: PassApache-2.0
Planoliver-kriska/claude-elixir-phoenix565—~1.6kAutomated safety check: PassMIT

Similar skills

  • Ecto Persistence Patterns

    georgeguimaraes/elixir-agent-tools

    Designs and debugs Elixir persistence with Ecto: schemas, changesets, queries, preloads, migrations and multi-tenancy, kept within application contexts.

    184 GitHub stars~1.2k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Oban Background Jobs

    georgeguimaraes/elixir-agent-tools

    Guidance for building and debugging durable background jobs in Elixir with Oban and Oban Pro, covering serialization, retries, uniqueness, chaining, chunking and workflows.

    184 GitHub stars~2.2k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Elixir OTP Concurrency

    georgeguimaraes/elixir-agent-tools

    Guides choices among GenServer, Supervisor, Task, Registry, ETS and Broadway when designing or debugging Elixir concurrency, state and fault recovery.

    184 GitHub stars~1.2k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Phoenix LiveView Patterns

    georgeguimaraes/elixir-agent-tools

    Guidance for building and debugging Phoenix web interfaces: where LiveView loads data, scopes, PubSub topics, external polling and component state.

    184 GitHub stars~1.3k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Plan

    oliver-kriska/claude-elixir-phoenix

    Plan features spanning multiple domains: billing (Stripe), auth (RBAC), real-time (Presence), webhooks, jobs (Oban).

    565 GitHub stars~1.6k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Elixir Expert

    pass-agent/loomkin

    Expert in Elixir, Phoenix Framework, and OTP. An agent skill from pass-agent/loomkin.

    181 GitHub starsUsed in 1 repo~796 tokens
    AI & LLM EngineeringAuto-check passed

More from z80dev/lemon

  • Debug and stress-test lemon gateway behavior by acting as both sides of Telegram conversations: run lemon-gateway with debug logs, then use Telethon with user credentials to send/reply messages in a…

    132 GitHub stars~744 tokensUpdated today
    Auto-check: notes
  • Verify Lemon

    z80dev/lemon

    Verify lemon features against a running (or disposable) instance using the cheapest sufficient tier: DIRECT (attach/RPC + control-plane WS + bus observation, no Telegram), FAKE TELEGRAM (hermetic…

    132 GitHub stars~4k tokensUpdated today
    Auto-check: notes
  • Pinata

    z80dev/lemon

    Pin files and JSON to IPFS via Pinata (JWT auth + helper scripts).

    132 GitHub stars~418 tokensUpdated today
    Auto-check passed
  • Discord Client

    z80dev/lemon

    Interact with Discord via a bot: read channels, send messages, list guilds/channels, upload files, manage threads.

    132 GitHub stars~771 tokensUpdated today
    Auto-check: notes
  • Session Logs

    z80dev/lemon

    Search and analyze your own Lemon session logs (older/parent conversations) using jq.

    132 GitHub stars~949 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Runtime Remsh

What does Runtime Remsh do?

Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval. Runtime Remsh is an agent skill from z80dev/lemon. Connect to a running Lemon or lemon-gateway BEAM node, run recompile() for hot code reload, and execute Elixir code in that live runtime via IEx remsh or rpc-eval.

When should I use Runtime Remsh?

Runtime Remsh fits situations like: backend & APIs work in your project.

How do I install Runtime Remsh in Claude Code?

Run `npx skills add z80dev/lemon --skill runtime-remsh -a claude-code`. Or copy the skill folder (apps/lemon_skills/priv/builtin_skills/runtime-remsh in z80dev/lemon) into .claude/skills/runtime-remsh in your project. Claude Code loads it when a task matches its description.

How do I install Runtime Remsh in Codex?

Run `npx skills add z80dev/lemon --skill runtime-remsh -a codex`. Or copy the skill folder (apps/lemon_skills/priv/builtin_skills/runtime-remsh in z80dev/lemon) into .agents/skills/runtime-remsh in your project. Codex loads it when a task matches its description.

Can I use Runtime Remsh 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 z80dev/lemon --skill runtime-remsh -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/runtime-remsh, .gemini/skills/runtime-remsh, .github/skills/runtime-remsh and .opencode/skills/runtime-remsh in your project.

What does Runtime Remsh need to run?

SKILL.md names no scripts, command-line tools or credentials: Runtime Remsh is instructions for the agent only.

Does Runtime Remsh access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Runtime Remsh 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 Runtime Remsh use?

Runtime Remsh 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 Runtime Remsh use?

About 819 tokens (SKILL.md is roughly 3.3k 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 Runtime Remsh?

Skills that share tags, products or a category with Runtime Remsh: Ecto Persistence Patterns (georgeguimaraes/elixir-agent-tools, 184 stars), Oban Background Jobs (georgeguimaraes/elixir-agent-tools, 184 stars), Elixir OTP Concurrency (georgeguimaraes/elixir-agent-tools, 184 stars) and Phoenix LiveView Patterns (georgeguimaraes/elixir-agent-tools, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Runtime Remsh?

z80dev (a GitHub user) maintains it in z80dev/lemon, which has 132 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

Source: z80dev/lemon on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.