Imported from arpitjalan/discourse-steward (.claude/skills/local-dev-setup/SKILL.md). Install upstream with npx skills add arpitjalan/discourse-steward --skill local-dev-setup. Copyright stays with the author.

Local dev setup

Use scripts/setup-local-dev.sh to connect Discourse to an existing local term-llm container. It configures chat and forum actions; prefer it to manual setup.

Prerequisites

• Discourse is running at localhost:3000, with this plugin symlinked into it.
• The chosen agent's term-llm contain container is running (docker ps).
• Use the agent name established in the conversation; if ambiguous, ask which agent to configure. It selects both the container and the Discourse username. Do not use a human account: the script changes that account's permissions.

Run the setup

Run from the plugin repository:

scripts/setup-local-dev.sh                       # shared admin bot "stan"
scripts/setup-local-dev.sh john                  # another shared bot name
scripts/setup-local-dev.sh stan-arpit --owner arpit # personal, non-admin TL4 bot

The script installs the forum skill and credentials, configures the plugin, applies forum layout defaults, restarts the agent, and checks its access to Discourse. Personal setup adds a registry entry; shared setup uses global settings. After personal setup, restart Discourse as the script instructs.

Reruns reuse the forum API key; add --new-key to replace the configured key. The script overwrites /home/agent/.zshenv, so preserve any unrelated entries before running it. Avoid running it during a chat unless the user has accepted the interruption.

If the connection check fails

• First check that Discourse responds at 127.0.0.1:3000.
• Linux: the script runs a background forwarder from the Docker gateway to Discourse. Rerun the script if that process has stopped. If ufw blocks the connection, ask the user to run the printed sudo ufw rule, then retest.
• macOS: Docker Desktop supplies host.docker.internal, so no forwarder or ufw rule is needed. For another container runtime, check that it provides a reachable host address.

For installation and further troubleshooting, read docs/local-dev.md in this repository. For a live forum with a remote term-llm server, use docs/remote-setup.md.