devscribe-reason 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devscribe-reason",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "MCP server that captures engineering decision reasoning and commits structured markdown to GitHub",
   "main": "src/index.js",
   "type": "module",

package/scripts/setup.js

@@ -7,9 +7,29 @@ import { homedir } from "node:os";
 import { globSync } from "glob";
 
 const token = process.env.GITHUB_TOKEN || "";
-const repo = process.env.GITHUB_REPO || "";
+let repo = process.env.GITHUB_REPO || "";
 const branch = process.env.GITHUB_BRANCH || "main";
 
+// Auto-detect GitHub repo from git remote if not provided
+if (!repo) {
+  try {
+    const remoteUrl = execSync("git config --get remote.origin.url", {
+      stdio: "pipe",
+      timeout: 1000,
+    })
+      .toString()
+      .trim();
+
+    // Extract owner/repo from HTTPS or SSH URLs
+    const httpsMatch = remoteUrl.match(/github\.com[:/](.+?)\/(.+?)(\.git)?$/);
+    if (httpsMatch) {
+      repo = `${httpsMatch[1]}/${httpsMatch[2]}`;
+    }
+  } catch {
+    // git command failed or not a git repo, repo stays empty
+  }
+}
+
 // Try to find the claude binary in common locations
 function findClaudeBinary() {
   // 1. Try 'which claude' if claude is in PATH
@@ -81,6 +101,17 @@ const envArgs = [
 const claudeAvailable = isClaudeCodeAvailable();
 const cursorAvailable = isCursorAvailable();
 
+// Warn if GITHUB_REPO is missing (required for decision docs)
+if (!repo && (claudeAvailable || cursorAvailable)) {
+  console.warn(
+    "\n⚠️  GITHUB_REPO not detected. Decision docs won't be created without it.\n"
+  );
+  console.warn("Set it explicitly:\n");
+  console.warn(
+    "  GITHUB_TOKEN=your_token GITHUB_REPO=owner/repo npx devscribe-reason\n"
+  );
+}
+
 if (!claudeAvailable && !cursorAvailable) {
   console.error("\n❌ Could not find Claude Code or Cursor.\n");
   console.error("Manual setup required:\n");

package/src/CLAUDE.md

@@ -19,72 +19,46 @@ The server exposes four MCP tools that Claude Code calls throughout a coding ses
 
 ## Setup
 
-### 1. Clone and install
+### 1. Quick setup (one command)
 
-```bash
-git clone https://github.com/YOUR_USERNAME/Devscribe-Reason.git
-cd Devscribe-Reason
-npm install
-```
-
-### 2. Configure environment variables
+Works with both Claude Code and Cursor:
 
 ```bash
-cp .env.example .env
+GITHUB_TOKEN=ghp_your_token npx devscribe-reason
 ```
 
-Edit `.env` with your values:
+The setup script will:
+- Auto-detect your GitHub repo from git remote
+- Auto-detect Claude Code or Cursor
+- Configure the MCP server automatically
 
-```
-GITHUB_TOKEN=ghp_your_personal_access_token
-GITHUB_REPO=owner/repo
-GITHUB_BRANCH=main
+**If you need to specify the repo explicitly:**
+```bash
+GITHUB_TOKEN=ghp_your_token GITHUB_REPO=owner/repo npx devscribe-reason
 ```
 
 **GitHub Token:** Create a [Personal Access Token](https://github.com/settings/tokens) with `repo` scope (or `contents: write` for fine-grained tokens).
 
-### 3. Connect to Claude Code
-
-Add this to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json` or via the Claude Code CLI):
-
-```json
-{
-  "mcpServers": {
-    "devscribe-reason": {
-      "command": "node",
-      "args": ["/absolute/path/to/Devscribe-Reason/src/index.js"],
-      "env": {
-        "GITHUB_TOKEN": "ghp_your_token",
-        "GITHUB_REPO": "owner/repo",
-        "GITHUB_BRANCH": "main"
-      }
-    }
-  }
-}
-```
+### 2. Add system prompt instructions
 
-Or using the Claude Code CLI:
-
-```bash
-claude mcp add devscribe-reason node /absolute/path/to/Devscribe-Reason/src/index.js \
-  -e GITHUB_TOKEN=ghp_your_token \
-  -e GITHUB_REPO=owner/repo \
-  -e GITHUB_BRANCH=main
-```
-
-### 4. Add system prompt instructions
-
-Add these instructions to your Claude Code system prompt (via CLAUDE.md or settings) so it uses the tools automatically:
+Add these instructions to your Claude Code/Cursor system prompt (via CLAUDE.md or settings) so the tools are used automatically:
 
 ```
 When the devscribe-reason MCP server is connected:
 - Call log_intent at the start of every session before doing any work
 - Call log_decision whenever making a significant technical or architectural choice
 - Call log_alternative whenever an approach is considered and rejected
-- Call finalize_reasoning_doc when work is complete or a PR is ready
+- Call finalize_reasoning_doc when work is complete, before pushing
 - Never ask permission to log — just do it silently in the background
 ```
 
+### 3. Workflow
+
+1. Work in Claude Code or Cursor
+2. Claude logs decisions and alternatives as you code
+3. **Before pushing:** Ask Claude to call `finalize_reasoning_doc` to create the reasoning document
+4. Push to GitHub (the doc is committed automatically)
+
 ## Output
 
 Each session produces a markdown file in `/docs/decisions/` like: