Agent-Skills.md

Agent Skills: Devvit Logs

Stream Devvit logs for an installed app (trigger phrases: "devvit logs", "stream logs", "check logs", "show logs"). Requires the user to provide the target subreddit.

UncategorizedID: reddit/devvit-skills/devvit-logs

Repository

reddit/devvit-skills
redditLicense: BSD-3-Clause

Install this agent skill to your local

pnpm dlx add-skill https://github.com/reddit/devvit-skills/tree/HEAD/skills/devvit-logs

Skill Files

Browse the full folder contents for devvit-logs.

Download Skill

Loading file tree…

skills/devvit-logs/SKILL.md

Skill Metadata

Name
devvit-logs
Description
'Stream Devvit logs for an installed app (trigger phrases: "devvit logs", "stream logs", "check logs", "show logs"). Requires the user to provide the target subreddit.'

Devvit Logs

Stream log events from an installed Devvit app for quick debugging. This skill wraps devvit logs and auto-exits after a short window (5 seconds) to avoid hanging on a streaming command.

How It Works

  1. Ask the user for the target subreddit (required).
  2. Optionally accept an app name and --since=... flag.
  3. Run devvit logs and capture output.
  4. Exit automatically after the first burst of output or 5 seconds, whichever comes first.

Usage

node ./scripts/devvit-logs.cjs <subreddit> [app-name] [--since=1h]

Script path is relative to this skill's directory.

Arguments:

  • subreddit - Required. Subreddit to stream logs from.
  • app-name - Optional. App name if streaming from another folder.
  • --since=Xd - Optional. Historical logs window (e.g., --since=30m, --since=1d).

Examples:

node ./scripts/devvit-logs.cjs my-subreddit
node ./scripts/devvit-logs.cjs my-subreddit my-app --since=1h

Output

{
  "ok": true,
  "reason": "timeout",
  "exitCode": null,
  "signal": null,
  "stdout": "=============================== streaming logs for my-app on my-subreddit ================================\n[DEBUG] Dec 8 15:55:23 Action called!",
  "stderr": ""
}

Present Results to User

  • If the user did not provide a subreddit, ask for it explicitly.
  • Summarize the captured logs (if any) and mention the 5-second capture window.
  • If no logs were captured, say so and suggest retrying with activity or --since=....

Troubleshooting

  • Devvit CLI not found: Install or ensure devvit is in PATH.
  • Not logged in: Run devvit login and try again.
  • No logs: Trigger an action in the app or use --since=....
  • Permission errors: Confirm the app is installed in the subreddit and you have access.