Your first slash command

This guide matches the minimal-bridge example when you pull the latest repo: a tiny register script plus an interactionCreate handler.

What you will feel

After this works, change the reply string in src/app.js, save, and restart only npm run app. The slash response updates without the long “bot is starting…” pause—because The Connection and Discord gateway stayed up in the bot terminal.

Prerequisites

Finished Getting started (bot + app running).
Node.js 22+.
A Discord Application ID (same as your bot’s application) and a guild id where you can install the bot (guild commands appear instantly for testing).

Add to your .env:

DISCORD_APPLICATION_ID — Developer Portal → your app → Application ID.
DISCORD_GUILD_ID — Server ID (enable Developer Mode → right‑click server → Copy ID).

Slash commands and registration

Shardwire delivers interactionCreate and interaction actions over The Connection. Registering the slash command with Discord is a separate one-time step (Discord REST API). That keeps your command list explicit and versioned—see replyToInteraction.

Keep npm run bot running in terminal A.

Run npm run register once (from the example). This creates a /hello command in your test guild.

Run npm run app in terminal B (or restart it after edits).

In Discord, type /hello. You should see Hello from Shardwire! (or whatever string you put in code).

Edit the reply text in src/app.js, save, restart only terminal B. Run /hello again—the new text appears without restarting the bot process.

What the app code is doing

You listen for interactionCreate, check for a slash interaction (chatInput) and your command name, then call replyToInteraction. Always branch on result.ok:

app.on('interactionCreate', async ({ interaction }) => {
  if (interaction.kind !== 'chatInput' || interaction.commandName !== 'hello') return;

  const result = await app.actions.replyToInteraction({
    interactionId: interaction.id,
    content: 'Hello from Shardwire!',
  });

  if (!result.ok) {
    console.error(result.error.code, result.error.message);
  }
});

Nothing happens?

Confirm the Guilds intent on the bot (needed for guild slash commands).
Re-run npm run register if you changed command name or guild.
Check Troubleshooting for capability-not-available and connection errors.

Your first slash command

Prerequisites

What the app code is doing

Reference

On this page