fix: append -raw suffix to saved research filenames

e.g. sam-altman-raw.md instead of sam-altman.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "last30days",
   "description": "Research any topic from the last 30 days across Reddit, X, YouTube, and the web",
-  "version": "2.1.0",
+  "version": "2.9.1",
   "author": {
     "name": "mvanhorn"
   },

CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.9.4] - 2026-03-06
+
+### Changed
+
+- Move save into Python script via `--save-dir` flag - raw research data saved during the existing script Bash call, zero extra tool calls after invitation
+- Remove entire "Save Research to Documents" section from SKILL.md (~45 lines removed)
+- No more `📎` footer, no Bash heredoc, no `(No output)`, no multi-minute cogitation after research
+
+## [2.9.3] - 2026-03-06
+
+### Fixed
+
+- **Critical:** Switch save from `run_in_background` to foreground Bash - background callbacks caused model to re-engage, hallucinate fake user messages, and generate unsolicited multi-paragraph responses
+- Save uses foreground `cat >` heredoc (executes sub-second, no callback, no delayed notification)
+
+## [2.9.2] - 2026-03-06
+
+### Fixed
+
+- Save research silently using background Bash heredoc instead of Write tool (eliminates "Wrote N lines..." clutter)
+- Suppress follow-up text after background save completes (no more "Research briefing saved..." noise)
+- Add `📎` footer line for save path instead of verbose confirmation
+
+## [2.9.1] - 2026-03-05
+
+### Highlights
+
+Auto-save research briefings to `~/Documents/Last30Days/` as topic-named .md files. Every run now builds a personal research library automatically - no more manual copy-paste.
+
+### Added
+
+- Auto-save complete research briefings (synthesis, stats, follow-up suggestions) to `~/Documents/Last30Days/{topic-slug}.md` after every run
+- Kebab-case filename generation from topic (e.g., "Claude Code skills" -> `claude-code-skills.md`)
+- Duplicate topic handling: appends date suffix instead of overwriting (e.g., `claude-code-skills-2026-03-05.md`)
+- Agent mode (`--agent`) also saves research files
+- Brief confirmation after save: "Saved to ~/Documents/Last30Days/{slug}.md"
+
+### Credits
+
+- [@devin_explores](https://x.com/devin_explores) -- Inspired this feature by sharing their workflow of saving every last30days run into organized .md files ([PR #51](https://github.com/mvanhorn/last30days-skill/pull/51))
+
 ## [2.9.0] - 2026-03-05
 
 ### Highlights
@@ -114,6 +155,7 @@ Three headline features: watchlists for always-on bots, YouTube transcripts as a
 
 Initial public release. Reddit + X search via OpenAI Responses API and xAI API.
 
+[2.9.1]: https://github.com/mvanhorn/last30days-skill/compare/v2.9.0...v2.9.1
 [2.9.0]: https://github.com/mvanhorn/last30days-skill/compare/v2.8.0...v2.9.0
 [2.8.0]: https://github.com/mvanhorn/last30days-skill/compare/v2.6.0...v2.8.0
 [2.1.0]: https://github.com/mvanhorn/last30days-skill/compare/v1.0.0...v2.1.0

README.md

@@ -1,7 +1,9 @@
-# /last30days v2.9
+# /last30days v2.9.1
 
 **The AI world reinvents itself every month. This skill keeps you current.** /last30days researches your topic across Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, and the web from the last 30 days, finds what the community is actually upvoting, sharing, betting on, and saying on camera, and writes you a grounded narrative with real citations. Whether it's Seedance 2.0 access, paper.design prompts, or the latest Nano Banana Pro techniques, you'll know what people who are paying attention already know.
 
+**New in v2.9.1 — Auto-save to ~/Documents/Last30Days/:** Every run now saves the complete briefing as a topic-named `.md` file to your Documents folder. Build a personal research library automatically. Inspired by [@devin_explores](https://x.com/devin_explores).
+
 **New in v2.9 — ScrapeCreators Reddit + Top Comments + Smart Discovery:**
 
 Reddit now runs on [ScrapeCreators](https://scrapecreators.com) by default — one `SCRAPECREATORS_API_KEY` covers Reddit, TikTok, and Instagram (3 sources, 1 key). Smart subreddit discovery finds the right communities automatically, and top comments are elevated with a 10% scoring weight and `💬` display with upvote counts. [Details below.](#whats-new-in-v29)

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: last30days
-version: "2.9"
+version: "2.9.2"
 description: "Research a topic from the last 30 days. Also triggered by 'last30'. Sources: Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, web. Become an expert and write copy-paste-ready prompts."
 argument-hint: 'last30 AI video tools, last30 best project management tools'
 allowed-tools: Bash, Read, Write, AskUserQuestion, WebSearch
@@ -30,7 +30,7 @@ metadata:
       - prompts
 ---
 
-# last30days v2.9: Research Any Topic from the Last 30 Days
+# last30days v2.9.4: Research Any Topic from the Last 30 Days
 
 Research ANY topic across Reddit, X, YouTube, TikTok, Hacker News, Polymarket, and the web. Surface what people are actually discussing, recommending, betting on, and debating right now.
 
@@ -123,6 +123,8 @@ If `--agent` appears in ARGUMENTS (e.g., `/last30days plaud granola --agent`):
 5. **Skip** the follow-up invitation ("I'm now an expert on X...")
 6. **Output** the complete research report and stop - do not wait for further input
 
+Agent mode saves raw research data to `~/Documents/Last30Days/` automatically via `--save-dir` (handled by the script, no extra tool calls).
+
 Agent mode report format:
 
 ```
@@ -165,7 +167,7 @@ if [ -z "${SKILL_ROOT:-}" ]; then
   exit 1
 fi
 
-python3 "${SKILL_ROOT}/scripts/last30days.py" "$ARGUMENTS" --emit=compact --no-native-web  # Add --x-handle=HANDLE if RESOLVED_HANDLE is set
+python3 "${SKILL_ROOT}/scripts/last30days.py" "$ARGUMENTS" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days  # Add --x-handle=HANDLE if RESOLVED_HANDLE is set
 ```
 
 Use a **timeout of 300000** (5 minutes) on the Bash call. The script typically takes 1-3 minutes.
@@ -498,7 +500,7 @@ For `/last30days war in Iran` (NEWS):
 
 ## WAIT FOR USER'S RESPONSE
 
-After showing the stats summary with your invitation, **STOP and wait** for the user to respond.
+**STOP and wait** for the user to respond. Do NOT call any tools after displaying the invitation. The research script already saved raw data to `~/Documents/Last30Days/` via `--save-dir`.
 
 ---
 
@@ -607,6 +609,7 @@ Want another prompt? Just tell me what you're creating next.
 - Optionally sends search queries to Brave Search API, Parallel AI API, or OpenRouter API for web search
 - Fetches public Reddit thread data from `reddit.com` for engagement metrics
 - Stores research findings in local SQLite database (watchlist mode only)
+- Saves research briefings as .md files to ~/Documents/Last30Days/
 
 **What this skill does NOT do:**
 - Does not post, like, or modify content on any platform

docs/plans/2026-03-05-feat-auto-save-results-to-documents-plan.md

@@ -0,0 +1,152 @@
+---
+title: "feat: Auto-save research results to ~/Documents/Last30Days/"
+type: feat
+status: completed
+date: 2026-03-05
+---
+
+# feat: Auto-save research results to ~/Documents/Last30Days/
+
+## Overview
+
+Every time the last30days skill completes a research run, automatically save the full briefing - inquiry, synthesis, stats, and follow-up suggestions - as a topic-named `.md` file in `~/Documents/Last30Days/`. Inspired by how users like @devin_explores are already manually saving results to build a personal research library (see screenshot - 17 topic files in a `Last30Days` Finder folder, each 9-34 KB).
+
+## Problem Statement / Motivation
+
+The skill's most valuable output - the assistant's synthesized "What I learned" briefing with stats and citations - only exists in the conversation. Once the session ends, it's gone. Users like @devin_explores work around this by manually copying output into .md files. Meanwhile, the Python script already writes raw data to `~/.local/share/last30days/out/`, but:
+
+1. It overwrites on every run (no history)
+2. It only contains pre-synthesis data (scored items), not the assistant's expert briefing
+3. It's in a hidden dot-directory users don't naturally browse
+
+The feature makes saving automatic and puts files where users expect them - the Documents folder, visible in Finder/file explorer.
+
+## Proposed Solution
+
+Add a **Write tool step in SKILL.md** after the synthesis/stats/invitation block that saves the complete briefing to `~/Documents/Last30Days/{topic-slug}.md`. This is a SKILL.md-only change (no Python script modifications needed) because the content to save is the assistant's synthesized output, which only exists in the SKILL.md flow.
+
+### Why SKILL.md, not the Python script
+
+The Python script (`last30days.py`) runs first and produces raw scored items. The assistant then synthesizes these into the "What I learned" briefing, stats block, and invitation. The synthesis is the valuable part - it's what @devin_explores is saving. The script can't produce this because it runs before synthesis happens.
+
+### File naming
+
+Convert the TOPIC variable to a kebab-case slug for the filename:
+- "Claude Code best practices" -> `claude-code-best-practices.md`
+- "best rap songs 2026" -> `best-rap-songs-2026.md`
+- "nano banana 2 prompting guide" -> `nano-banana-2-prompting-guide.md`
+
+This matches the screenshot pattern exactly (e.g., `anthropic-claude-code-best-practices.md`, `seedance-video-prompting-guide.md`).
+
+If a file with the same slug already exists, append a date suffix: `claude-code-best-practices-2026-03-05.md`. This handles re-researching the same topic without overwriting previous results.
+
+### File content
+
+The saved .md file should contain the complete research output in this order:
+
+```markdown
+# {TOPIC}
+
+> Researched {date} | Query type: {QUERY_TYPE} | Target tool: {TARGET_TOOL or "general"}
+
+## What I learned
+
+{The full synthesis section - topics, patterns, citations}
+
+## Stats
+
+{The full stats box with source counts and engagement}
+
+## Follow-up suggestions
+
+{The 2-3 specific suggestions from the invitation block}
+
+---
+*Generated by [last30days](https://github.com/mvanhorn/last30days-skill) v2.9*
+```
+
+### Implementation location in SKILL.md
+
+Insert a new section between the current "LAST - Invitation" display and the "WAIT FOR USER'S RESPONSE" section. The Write tool call happens silently - no user prompt, no opt-in. Just save and briefly confirm.
+
+## Technical Considerations
+
+- **Cross-platform paths**: `~/Documents/` exists on macOS and most Linux desktops. On systems where it doesn't exist, `mkdir -p` handles creation. Windows WSL users get it too.
+- **Permissions**: The Write tool in Claude Code can write to `~/Documents/` without issues. No sandbox concerns since this is the user's own Documents folder.
+- **Filename sanitization**: Strip special characters, collapse whitespace to hyphens, lowercase. Keep it simple - no need for a library, just basic string ops in the SKILL.md instructions.
+- **File size**: Based on the screenshot (9-34 KB files), the synthesis output is well within reasonable bounds.
+- **No opt-out flag needed initially**: This is the default behavior. If users complain, a `--no-save` flag can be added later. Start with always-on since the screenshot proves users want this.
+
+## Acceptance Criteria
+
+- [x] Running `/last30days {topic}` creates `~/Documents/Last30Days/{topic-slug}.md` automatically
+- [x] File contains: title, date, query metadata, full synthesis, stats block, follow-up suggestions
+- [x] Filename is kebab-case slug of the topic (e.g., `claude-code-skills-guide.md`)
+- [x] Duplicate topics get a date suffix instead of overwriting
+- [x] Directory `~/Documents/Last30Days/` is created automatically if it doesn't exist
+- [x] A brief confirmation line appears after the stats (e.g., "Saved to ~/Documents/Last30Days/claude-code-skills-guide.md")
+- [x] Agent mode (`--agent`) also saves the file
+- [x] No changes to the Python script - this is purely a SKILL.md addition
+
+## Implementation Steps
+
+### Step 1: Add save instructions to SKILL.md
+
+Insert a new section after the invitation block (after line ~496, before "WAIT FOR USER'S RESPONSE" at line ~499):
+
+**New section in `SKILL.md`:**
+
+```markdown
+## Save Research to Documents
+
+After displaying the invitation, save the complete research briefing:
+
+1. Generate the filename from TOPIC:
+   - Lowercase the topic
+   - Replace spaces and special characters with hyphens
+   - Remove consecutive hyphens
+   - Trim to 60 characters max
+   - Example: "Claude Code Best Practices" -> "claude-code-best-practices"
+
+2. Check if file already exists. If so, append today's date:
+   - "claude-code-best-practices.md" exists -> use "claude-code-best-practices-2026-03-05.md"
+
+3. Use the Write tool to save to ~/Documents/Last30Days/{slug}.md with this content:
+   - H1 title: the TOPIC
+   - Metadata line: date, QUERY_TYPE, TARGET_TOOL
+   - Full "What I learned" synthesis (everything you just displayed)
+   - Full stats block
+   - Follow-up suggestions from the invitation
+   - Footer with skill attribution
+
+4. Confirm briefly: "Saved to ~/Documents/Last30Days/{slug}.md"
+```
+
+### Step 2: Update agent mode section
+
+The `--agent` mode section (line ~116) skips interactive elements but should still save. Add a note that agent mode saves the file with the same logic.
+
+### Step 3: Update Security & Permissions section
+
+Add to the "What this skill does" list (line ~599):
+- "Saves research briefings as .md files to ~/Documents/Last30Days/"
+
+## Success Metrics
+
+- Users accumulate a browsable library of .md research files in their Documents folder
+- No more manual copy-paste workflow to save results
+- Files are immediately findable in Finder/file explorer search
+
+## Dependencies & Risks
+
+- **Low risk**: Write tool is already in the skill's `allowed-tools` list
+- **Low risk**: ~/Documents/ is a standard, user-owned directory
+- **Edge case**: If the skill is interrupted mid-run (before synthesis), no file is saved - this is correct behavior since there's nothing to save yet
+- **Edge case**: Very long topics could produce unwieldy filenames - the 60-char truncation handles this
+
+## Sources & References
+
+- Screenshot from @devin_explores showing manual .md file library in ~/Documents/Last30Days/
+- Current output pipeline: `scripts/lib/render.py:798` (`write_outputs()`) writes to `~/.local/share/last30days/out/`
+- SKILL.md synthesis flow: lines 275-496 (internalize research -> show summary -> invitation)
+- Existing `--emit` modes: `scripts/last30days.py:1700` (`output_result()`)

docs/plans/2026-03-06-fix-save-output-noise-plan.md

@@ -0,0 +1,83 @@
+---
+title: "fix: Eliminate save-related output noise after research"
+type: fix
+status: active
+date: 2026-03-06
+---
+
+# fix: Eliminate save-related output noise after research
+
+## Problem Statement
+
+After research completes, the auto-save feature adds 3-5 lines of unwanted output below the clean invitation block. Every approach tried so far has made things worse:
+
+| Version | Approach | Lines added | Side effects |
+|---------|----------|-------------|--------------|
+| v2.9.1 | `Write` tool | ~5 | Shows "Wrote 43 lines to..." |
+| v2.9.2 | `run_in_background: true` | ~5 | Background callback triggers 2-4 min cogitation, model hallucinates fake "Human:" messages and generates unsolicited multi-paragraph responses |
+| v2.9.3 | Foreground `cat >` heredoc | ~3 | Shows `(No output)`, still triggers 2-4 min cogitation |
+
+**Current v2.9.3 noise (3 lines):**
+```
+⏺ Bash(mkdir -p ~/Documents/Last30Days && cat > ...)
+  ⎿  (No output)
+✻ Churned for 2m 38s
+```
+
+The root cause is that ANY tool call after the invitation creates unavoidable Claude Code UI chrome, and the model cogitates for minutes regardless of foreground vs background.
+
+## Proposed Solutions
+
+### Option A: Remove auto-save entirely (Recommended)
+
+Remove the entire "Save Research to Documents" section from SKILL.md. The research lives in the conversation. Zero extra tool calls, zero extra lines, zero cogitation.
+
+**Changes to `SKILL.md`:**
+- Delete the "Save Research to Documents" section (~45 lines)
+- Update agent mode reference (line 126) - remove save mention
+- Update security section (line 612) - change "Saves research briefings" to past tense or conditional
+- Remove `📎` footer line from invitation format
+- Simplify "WAIT FOR USER'S RESPONSE" section
+
+**What users lose:** Auto-saved .md files in `~/Documents/Last30Days/`
+**What users gain:** Clean output ending exactly at the invitation block
+
+### Option B: Move save into Python script
+
+Add `--save-dir` flag to `last30days.py`. The script saves its raw output during its existing Bash call (which already runs). Zero extra tool calls.
+
+**Changes:**
+- `scripts/last30days.py` - add `--save-dir` argument, write raw output to file at end of execution
+- `SKILL.md` - add `--save-dir=~/Documents/Last30Days` to the script invocation, remove save section
+
+**What users lose:** Saved file contains raw research data, not Claude's synthesis
+**What users gain:** Zero extra lines, data is still preserved
+
+### Option C: Opt-in save via follow-up command
+
+Remove auto-save. Add a note to the invitation: "Say 'save' to save this research." When user says "save", run the Bash heredoc then.
+
+**Changes to `SKILL.md`:**
+- Delete auto-save section
+- Add "save" as a recognized intent in "WHEN USER RESPONDS" section
+- Save logic only runs when explicitly requested
+
+**What users lose:** Nothing - save is still available on demand
+**What users gain:** Clean output by default, save when they want it
+
+## Acceptance Criteria
+
+- [ ] Research output ends at the invitation block with zero tool calls after it
+- [ ] No `(No output)` line visible after invitation
+- [ ] No multi-minute cogitation after invitation
+- [ ] No hallucinated fake user messages
+- [ ] Version bumped to v2.9.4
+- [ ] CHANGELOG updated
+- [ ] Synced to ~/.claude, ~/.agents, ~/.codex via sync.sh
+
+## Context
+
+- Source: `/Users/mvanhorn/last30days-skill-private/SKILL.md`
+- Deployed to: `~/.claude/skills/last30days/SKILL.md`
+- Sync command: `bash scripts/sync.sh`
+- Current version: v2.9.3

release-notes.md

@@ -2,15 +2,19 @@ The AI world reinvents itself every month. This skill keeps you current.
 
 `/last30days` researches your topic across **Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, and the web** from the last 30 days, finds what the community is actually upvoting, sharing, betting on, and saying on camera, and writes you a grounded narrative with real citations.
 
+## What's New in v2.9.1
+
+**Auto-save to ~/Documents/Last30Days/.** Every run now saves the complete research briefing - synthesis, stats, and follow-up suggestions - as a topic-named `.md` file to your Documents folder. Build a personal research library without lifting a finger. Inspired by [@devin_explores](https://x.com/devin_explores) who was already doing this manually.
+
 ## Three Headline Features in v2.9
 
-**1. ScrapeCreators Reddit as default.** One `SCRAPECREATORS_API_KEY` now covers Reddit, TikTok, and Instagram — three sources, one key. No more `OPENAI_API_KEY` required for Reddit search. Faster, more reliable, and simpler to configure.
+**1. ScrapeCreators Reddit as default.** One `SCRAPECREATORS_API_KEY` now covers Reddit, TikTok, and Instagram - three sources, one key. No more `OPENAI_API_KEY` required for Reddit search. Faster, more reliable, and simpler to configure.
 
-**2. Smart subreddit discovery.** Relevance-weighted scoring replaces pure frequency count. Each candidate subreddit is scored by `frequency × recency × topic-word match`, and a `UTILITY_SUBS` blocklist filters noise subs like r/tipofmytongue. Search "Claude Code skills" and get r/ClaudeAI, r/ClaudeCode, r/openclaw — not generic programming subs.
+**2. Smart subreddit discovery.** Relevance-weighted scoring replaces pure frequency count. Each candidate subreddit is scored by `frequency x recency x topic-word match`, and a `UTILITY_SUBS` blocklist filters noise subs like r/tipofmytongue. Search "Claude Code skills" and get r/ClaudeAI, r/ClaudeCode, r/openclaw - not generic programming subs.
 
-**3. Top comments elevated.** The best comment on each Reddit thread now carries a 10% weight in engagement scoring and displays prominently with `💬` and upvote counts. Reddit's value is in the comments — now the skill surfaces them.
+**3. Top comments elevated.** The best comment on each Reddit thread now carries a 10% weight in engagement scoring and displays prominently with upvote counts. Reddit's value is in the comments - now the skill surfaces them.
 
-Plus: **Instagram Reels** (v2.8), **Polymarket prediction markets** (v2.5), **YouTube transcripts** (v2.1), **bundled X search** — no external CLI needed.
+Plus: **Instagram Reels** (v2.8), **Polymarket prediction markets** (v2.5), **YouTube transcripts** (v2.1), **bundled X search** - no external CLI needed.
 
 ## Beta Test Results (v2.9)
 

scripts/last30days.py

@@ -1250,6 +1250,13 @@ def main():
         default=False,
         help="Skip native web search backends (Parallel/Brave/OpenRouter). Use when the assistant has its own WebSearch tool.",
     )
+    parser.add_argument(
+        "--save-dir",
+        type=str,
+        default=None,
+        metavar="DIR",
+        help="Auto-save raw research output to DIR/{topic-slug}.md",
+    )
 
     args = parser.parse_args()
     args.topic = " ".join(args.topic) if args.topic else None
@@ -1604,6 +1611,20 @@ def main():
     # Output result
     output_result(report, args.emit, web_needed, args.topic, from_date, to_date, missing_keys, args.days, source_info)
 
+    # Auto-save raw research to file if --save-dir is set
+    if args.save_dir:
+        import re
+        save_dir = Path(args.save_dir).expanduser()
+        save_dir.mkdir(parents=True, exist_ok=True)
+        slug = re.sub(r'[^a-z0-9]+', '-', args.topic.lower()).strip('-')[:60]
+        save_path = save_dir / f"{slug}-raw.md"
+        if save_path.exists():
+            save_path = save_dir / f"{slug}-raw-{datetime.now().strftime('%Y-%m-%d')}.md"
+        content = render.render_compact(report, missing_keys=missing_keys)
+        content += "\n" + render.render_source_status(report, source_info)
+        save_path.write_text(content, encoding="utf-8")
+        print(f"📎 {save_path}", file=sys.stderr)
+
     # Persist findings to SQLite if requested
     if args.store:
         import store as store_mod