feat(install-plugins): interactive ctx7 login + auto-setup, ignore find-docs

STEP 6 ctx7 auth, when anonymous:
- interactive TTY -> prompt [y/N] then run `ctx7 login`; non-interactive
  (CI/headless/re-run) keeps text guidance, never opens a browser or blocks.
- run `ctx7 setup --claude --cli` when the find-docs skill is absent, to
  (re)install CLI+Skills mode. Guarded on absence so a re-run never clobbers
  a customized ~/.claude/rules/context7.md.

gitignore skills/find-docs/: it is a ctx7-managed skill materialized by
`ctx7 setup --claude --cli` into ~/.claude/skills (symlink to repo skills/),
re-created on demand by Step 6 — not vendored here.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C8bmCXTHNccS7KRV4gWXEF

.gitignore

@@ -69,6 +69,11 @@ skills/frontend-design
 skills/darwin-skill
 skills/find-skills
 
+# Context7 docs-lookup skill — installed by `ctx7 setup --claude --cli`
+# (install-plugins.sh Step 6, when absent) into ~/.claude/skills (a symlink to
+# this repo's skills/). ctx7-managed and re-created on demand — not vendored here.
+skills/find-docs/
+
 # Staging area used by lib/toggle-external.sh when disabling a tool
 skills-disabled/
 

install-plugins.sh

@@ -573,7 +573,8 @@ else
     err "ctx7 install failed — run manually: npm install -g ctx7"
   fi
 fi
-# ctx7 auth — detect + guide only (an installer must never open a browser / log you in)
+# ctx7 auth — detect, then offer login ONLY in an interactive TTY. A non-interactive
+# run (CI / headless / re-run) must never open a browser or block on OAuth.
 if command -v ctx7 &>/dev/null; then
   # Deterministic offline oracle: ctx7's OAuth token lives here (XDG-aware).
   # Present => authenticated; absent => anonymous. No subprocess, no network, no browser.
@@ -582,8 +583,35 @@ if command -v ctx7 &>/dev/null; then
     ok "ctx7 authenticated (full rate limits)"
   else
     info "ctx7 works anonymously — docs + library already usable, no auth required."
-    info "For higher rate limits, authenticate:  ctx7 login   (opens a browser)"
+    if [ -t 0 ] && [ -t 1 ]; then
-    info "  headless:  ctx7 login --no-browser   (prints a URL to open yourself)"
+      # Interactive terminal: offer to log in now (opens a browser).
+      printf '%b' "${BLUE}→${NC} Authenticate ctx7 now for higher rate limits? [y/N] "
+      read -r ctx7_ans || ctx7_ans=""
+      if [[ "$ctx7_ans" =~ ^[Yy]([Ee][Ss])?$ ]]; then
+        if ctx7 login; then
+          ok "ctx7 authenticated (full rate limits)"
+        else
+          warn "ctx7 login did not finish — re-run 'ctx7 login' anytime"
+        fi
+      else
+        info "Skipped — authenticate later with:  ctx7 login"
+      fi
+    else
+      # Non-interactive (CI / headless / re-run): never block — just guide.
+      info "For higher rate limits, authenticate:  ctx7 login   (opens a browser)"
+      info "  headless:  ctx7 login --no-browser   (prints a URL to open yourself)"
+    fi
+  fi
+  # CLI + Skills mode: install the find-docs skill into ~/.claude/skills when
+  # absent (it is gitignored — ctx7 owns it, this regenerates it on a fresh
+  # clone). Guarded on absence so a re-run never clobbers a customized config
+  # (setup also (re)writes ~/.claude/rules/context7.md).
+  if [ ! -f "$HOME/.claude/skills/find-docs/SKILL.md" ]; then
+    if ctx7 setup --claude --cli -y </dev/null &>/dev/null; then
+      ok "ctx7 CLI + Skills configured (find-docs skill installed)"
+    else
+      warn "ctx7 setup failed — run manually: ctx7 setup --claude --cli"
+    fi
   fi
   info "Standalone usage:  ctx7 docs /vercel/next.js \"middleware\""
 fi