fix: support REPOWISE_PORT env var in serve command

[muhamedfazalps]

Problem

Fixes #427 — Setting REPOWISE_PORT in your .env file (as documented in .env.example) has no effect. The repowise serve command always starts on the default port 7337 because the --port click option doesn't read from the REPOWISE_PORT environment variable.

Root Cause

At /packages/cli/src/repowise/cli/commands/serve_cmd.py:481, the --port option was defined as:

@click.option("--port", default=7337, type=int, help="API server port.")

Click supports reading from environment variables natively via envvar=, but it wasn't wired up. So even when REPOWISE_PORT=7000 is set in .env and loaded by load_dotenv(), the option always used its hardcoded default of 7337.

Fix

Added envvar="REPOWISE_PORT" to the click option:

@click.option("--port", default=7337, type=int, help="API server port.", envvar="REPOWISE_PORT")

Now:

1. REPOWISE_PORT is read from the environment (set via .env or export)
2. --port CLI flag still takes precedence over the env var
3. Falls back to 7337 if neither is provided

Testing

• Set REPOWISE_PORT=7000 in .env, run repowise serve → API starts on 7000
• Run repowise serve --port 8000 → CLI flag overrides env var
• Run repowise serve without env var → starts on 7337

---

If this fix helped, consider buying me a coffee! ☕

[repowise-bot]

✅ Health: 7.7 (unchanged)
_{1 hotspot · 5 hidden couplings · 1 with fix history}

🩹 Review priority _{(files here with the most recent bug-fix history — defects cluster, so review these first)}

• .../commands/serve_cmd.py — fixed 8× in the last ~6 months

🧪 No test files were touched in this PR — consider adding coverage for the files above.

🔥 Hotspot touched (1)

• .../commands/serve_cmd.py — 16 commits/90d, 1 dependents · primary owner: Raghav Chamadiya (72%)

🔗 Hidden coupling (1 file)

• .../commands/serve_cmd.py co-changes with these files (not in this PR):
  • .../cli/helpers.py (4× — 🟢 routine)
  • pyproject.toml (4× — 🟢 routine)
  • .../server/provider_config.py (3× — 🟢 routine)
  • .../server/app.py (3× — 🟢 routine)
  • .../persistence/database.py (3× — 🟢 routine)

---

📊 Full report · ⭐ Star Repowise · 📥 Install bot · Last updated 2026-06-11 13:10 UTC
_{Silence on a single PR with [skip repowise] in the title · Per-repo toggle on repowise.dev/settings?tab=bot}