subscope-setup

/subscope-setup

Reconfiguration tool for an already-onboarded subscope install. For first-run, route the user to /subscope-onboard instead. The 6 steps below are now individually addressable: ask the user which one they want to change before walking the whole flow.

Goal

Let an existing user change one piece of their config without re-doing the whole onboarding.

Procedure

First, check whether the user has already onboarded:

[ -f ~/.config/subscope/subreddits.yml ] && echo "ONBOARDED" || echo "NOT_ONBOARDED"

If NOT_ONBOARDED: redirect to /subscope-onboard and stop. Do not run the steps below for a new install.

If ONBOARDED: ask which piece they want to change:

What do you want to reconfigure?

1. LLM provider (add or swap)
2. Targeting (re-pick preset, or re-run /subscope-onboard for full re-do)
3. Notion database
4. Slack webhook
5. Obsidian vault

Pick a number, or type "all" to walk every step.

Then jump to that step only. Each step is independent.

Step 1 — LLM provider (optional)

Tell the user:

subscope has three classification tiers:

1. Default: regex-only gate, zero cost, no API key needed.
2. Interactive: /subscope-judge <surface-id> uses your Claude Code subscription, free.
3. Bulk LLM: any OpenAI-compatible provider (Anthropic, OpenAI, Groq, OpenRouter, Together, local Ollama). ~$0.50/day at 5K posts.

Want to enable the bulk-LLM tier? (yes / skip)

If yes, the user sets one env var (LLM_API_KEY, or legacy ANTHROPIC_API_KEY / OPENAI_API_KEY). The base URL is auto-detected from the key prefix (sk-ant- → Anthropic /openai/v1, sk-or- → OpenRouter, gsk_ → Groq, else OpenAI). For local Ollama or a custom endpoint, also set LLM_BASE_URL.

To lock the preference, write a minimal ~/.config/subscope/llm.json:

{"provider": "openai_compatible"}

Test the resolved config (this will also fail loudly if LLM_BASE_URL targets a private IP — the SSRF guard is intentional):

cd "$CLAUDE_PLUGIN_ROOT" && PYTHONPATH=engine python3 -c "
from subscope.lib import classify
import json
print(json.dumps(classify.status(), indent=2))
"