ramble-vault 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 THENEXTCO INC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# ramble-vault
+
+Connect [Ramble On](https://apps.apple.com/app/ramble-on) voice notes to Claude Code.
+
+## Setup
+
+1. In Ramble On → Settings → enable **Markdown Sync** and pick an iCloud Drive folder
+2. Run:
+
+```bash
+npx ramble-vault
+```
+
+3. Open Claude Code and ask about your recordings
+
+## What it does
+
+- Finds your Ramble On notes in iCloud Drive
+- Adds the folder to Claude Code's `additionalDirectories`
+- Installs 3 skills:
+
+| Skill | What it does |
+|-------|-------------|
+| `/recall <query>` | Search voice notes by content, date, context, or speakers |
+| `/ideas` | Find cross-domain patterns and connections across all notes |
+| `/trace <topic>` | Track how an idea evolved over time |
+
+## Requirements
+
+- macOS (iCloud Drive must be enabled)
+- [Claude Code](https://claude.ai/code) installed
+- Ramble On with Markdown Sync enabled
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const ICLOUD_BASE = path.join(
+  os.homedir(),
+  "Library/Mobile Documents/com~apple~CloudDocs"
+);
+const CLAUDE_DIR = path.join(os.homedir(), ".claude");
+const SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
+const SKILLS_DIR = path.join(CLAUDE_DIR, "skills");
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`  \x1b[31m✗\x1b[0m ${msg}`);
+}
+
+// Find the Ramble On vault in iCloud Drive
+function findVault() {
+  if (!fs.existsSync(ICLOUD_BASE)) {
+    return null;
+  }
+
+  // Recursively search for a CLAUDE.md containing "Ramble On"
+  function search(dir, depth) {
+    if (depth > 3) return null;
+
+    const claudeMd = path.join(dir, "CLAUDE.md");
+    if (fs.existsSync(claudeMd)) {
+      try {
+        const content = fs.readFileSync(claudeMd, "utf-8");
+        if (content.includes("Ramble On")) {
+          return dir;
+        }
+      } catch {}
+    }
+
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        if (entry.name.startsWith(".")) continue;
+        const result = search(path.join(dir, entry.name), depth + 1);
+        if (result) return result;
+      }
+    } catch {}
+
+    return null;
+  }
+
+  // Check common name first
+  const defaultPath = path.join(ICLOUD_BASE, "RambleOnNotes");
+  if (fs.existsSync(defaultPath)) {
+    const claudeMd = path.join(defaultPath, "CLAUDE.md");
+    if (fs.existsSync(claudeMd)) {
+      return defaultPath;
+    }
+  }
+
+  return search(ICLOUD_BASE, 0);
+}
+
+// Add vault path to Claude Code settings
+function addToSettings(vaultPath) {
+  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+
+  let settings = {};
+  if (fs.existsSync(SETTINGS_PATH)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf-8"));
+    } catch {
+      settings = {};
+    }
+  }
+
+  if (!Array.isArray(settings.additionalDirectories)) {
+    settings.additionalDirectories = [];
+  }
+
+  if (!settings.additionalDirectories.includes(vaultPath)) {
+    settings.additionalDirectories.push(vaultPath);
+    fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+    return true;
+  }
+
+  return false; // already present
+}
+
+// Install skills to ~/.claude/skills/
+function installSkills() {
+  fs.mkdirSync(SKILLS_DIR, { recursive: true });
+
+  const skillsSource = path.join(__dirname, "..", "skills");
+  const files = fs.readdirSync(skillsSource).filter((f) => f.endsWith(".md"));
+  const installed = [];
+
+  for (const file of files) {
+    const src = path.join(skillsSource, file);
+    const dest = path.join(SKILLS_DIR, file);
+    fs.copyFileSync(src, dest);
+    installed.push(file.replace(".md", ""));
+  }
+
+  return installed;
+}
+
+// Main
+function main() {
+  console.log();
+  console.log("  \x1b[1mRamble On → Claude Code\x1b[0m");
+  console.log();
+
+  // Step 1: Find vault
+  log("Looking for voice notes in iCloud Drive...");
+  const vaultPath = findVault();
+
+  if (!vaultPath) {
+    error("Could not find Ramble On notes in iCloud Drive.");
+    console.log();
+    log("Make sure you've:");
+    log("  1. Enabled Markdown Sync in Ramble On settings");
+    log("  2. Picked an iCloud Drive folder");
+    log("  3. Exported at least one recording");
+    console.log();
+    log("Then run this command again.");
+    console.log();
+    process.exit(1);
+  }
+
+  success(`Found vault: ${vaultPath}`);
+
+  // Step 2: Add to Claude Code settings
+  const added = addToSettings(vaultPath);
+  if (added) {
+    success("Added to Claude Code settings");
+  } else {
+    success("Already in Claude Code settings");
+  }
+
+  // Step 3: Install skills
+  const skills = installSkills();
+  success(`Installed skills: ${skills.map((s) => `/${s}`).join(", ")}`);
+
+  // Done
+  console.log();
+  console.log("  \x1b[1m\x1b[32mDone!\x1b[0m Open Claude Code and try:");
+  console.log();
+  console.log("    \x1b[36m/recall\x1b[0m what did I talk about this week?");
+  console.log("    \x1b[36m/ideas\x1b[0m");
+  console.log("    \x1b[36m/trace\x1b[0m pricing strategy");
+  console.log();
+}
+
+main();

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "ramble-vault",
+  "version": "0.1.0",
+  "description": "Connect Ramble On voice notes to Claude Code",
+  "bin": {
+    "ramble-vault": "bin/cli.js"
+  },
+  "keywords": [
+    "claude-code",
+    "voice-notes",
+    "ramble-on",
+    "transcription"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arnabing/ramble-vault"
+  }
+}

package/skills/ideas.md

@@ -0,0 +1,25 @@
+---
+name: ideas
+description: Find cross-domain patterns and connections across all voice notes
+user_invocable: true
+---
+
+Scan all Ramble On voice notes across all context folders to find patterns the user might not see.
+
+The voice notes folder is in additionalDirectories — look for the folder containing a CLAUDE.md with "Ramble On" in it.
+
+## What to do
+
+1. Read recent notes across all context folders (brain-dump, journal, work, medical, legal, school)
+2. Identify recurring themes, people, topics, or concerns
+3. Find connections between different domains (e.g., a work frustration that echoes a journal entry)
+4. Surface ideas the user has been circling but hasn't explicitly named
+
+## What to present
+
+- **Patterns found**: Recurring themes with evidence from specific notes
+- **Connections**: Links between notes in different contexts
+- **Unnamed ideas**: Things the user keeps coming back to but hasn't crystallized
+- **Suggested next steps**: Based on where their thinking seems to be heading
+
+Keep it concise. Lead with the most interesting or surprising finding.

package/skills/recall.md

@@ -0,0 +1,26 @@
+---
+name: recall
+description: Search your Ramble On voice notes for information matching a query
+user_invocable: true
+---
+
+Search the user's Ramble On voice notes for information matching their query.
+
+The voice notes folder is in additionalDirectories — look for the folder containing a CLAUDE.md with "Ramble On" in it.
+
+## How to search
+
+1. **By content**: Grep for keywords across all .md files in the vault
+2. **By frontmatter**: Search YAML fields — `date`, `context` (brain-dump, journal, medical, work, legal, school), `speakers`, `duration`
+3. **By filename**: Files are named `{context}/{YYYY-MM-DD}-{slug}.md`
+
+## What to return
+
+- Relevant excerpts with source file references
+- The AI-generated summary sections (## headings) are more useful than raw transcripts
+- Include the date and context for each match
+- If multiple notes match, summarize across them
+
+## Arguments
+
+If the user provides a query after `/recall`, search for that. If no query, ask what they're looking for.

package/skills/trace.md

@@ -0,0 +1,30 @@
+---
+name: trace
+description: Track how an idea evolved across voice notes over time
+user_invocable: true
+---
+
+Search Ramble On voice notes for a given topic and show how the user's thinking evolved over time.
+
+The voice notes folder is in additionalDirectories — look for the folder containing a CLAUDE.md with "Ramble On" in it.
+
+## Arguments
+
+The user provides a topic after `/trace` (e.g., `/trace pricing strategy`). If no topic, ask what to trace.
+
+## What to do
+
+1. Search all voice notes for the topic — grep content, titles, and frontmatter
+2. Order matches chronologically by the `date` field in YAML frontmatter
+3. Read each matching note to understand the user's position at that point
+
+## What to present
+
+A timeline narrative showing:
+- **First mention**: When and where the idea first appeared
+- **Evolution**: How the thinking changed over time
+- **Perspective shifts**: Moments where the user changed their mind or gained new insight
+- **Current state**: Where the thinking stands as of the most recent note
+- **Confidence trajectory**: Did they become more or less certain?
+
+Present as a readable narrative, not a list. Quote key phrases from the notes.