devmem 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nikhil Dhaliya
+
+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,152 @@
+# DevMem
+
+> Generate persistent, domain-specific context files for AI tools.
+
+DevMem scans your codebase and generates structured context files that any AI tool can use to instantly understand your project - no more re-explaining.
+
+---
+
+##  Features
+
+- **Folder-aware output** — generates one `.md` per top-level folder, named to match your project structure
+- **Targeted generation** — generate context for a specific folder, subfolder, or file with `--only`
+- **Multi-provider AI** — supports Gemini, OpenAI, and Anthropic
+- **Smart scanning** — ignores `node_modules`, binaries, lockfiles, and respects size limits
+- **AI-optimized output** — concise, structured, bullet-point context that fits in LLM context windows
+
+---
+
+##  Installation
+
+```bash
+# Clone and install
+git clone https://github.com/NikhilDhaliya/devmem.git
+cd devmem
+npm install
+npm run build
+npm link
+```
+
+---
+
+##  Usage
+
+### 1. Setup your AI provider
+
+```bash
+devmem setup
+```
+
+Choose between **Gemini**, **OpenAI**, or **Anthropic**, enter your API key, and optionally pick a model.
+
+```bash
+# View current config
+devmem setup --show
+
+# Remove config and API key
+devmem setup --remove
+```
+
+### 2. Generate context
+
+Navigate to any project and run:
+
+```bash
+devmem generate
+```
+
+This scans your project and creates `.dev/<folder>.md` for each top-level folder:
+
+```
+my-app/
+├── client/       →  .dev/client.md
+├── server/       →  .dev/server.md
+├── shared/       →  .dev/shared.md
+├── package.json  →  .dev/root.md
+```
+
+### 3. Targeted generation
+
+Generate context for specific parts of your project:
+
+```bash
+# Single folder
+devmem generate --only client
+
+# Multiple folders
+devmem generate --only "client,server"
+
+# Subfolder or feature
+devmem generate --only src/auth
+
+# Specific file
+devmem generate --only src/utils/db.ts
+```
+
+> **Note:** Even with `--only`, DevMem sends the **full project** to the AI so it understands the complete picture, but generates documentation only for the targeted area.
+
+### 4. Custom output directory
+
+```bash
+devmem generate -o context/
+```
+
+---
+
+##  Configuration
+
+Config is stored in `~/.devmem/config.json`:
+
+```json
+{
+  "provider": "gemini",
+  "apiKey": "your-api-key",
+  "model": "gemini-2.0-flash"
+}
+```
+
+### Default models
+
+| Provider  | Default Model            |
+|-----------|--------------------------|
+| Gemini    | `gemini-2.0-flash`       |
+| OpenAI    | `gpt-4o-mini`            |
+| Anthropic | `claude-3-5-haiku-latest` |
+
+---
+
+##  Philosophy
+
+DevMem is **not** an AI assistant or agent. It's a **context preservation layer** for developers:
+
+- Scan once, reuse everywhere
+- Works with ChatGPT, Claude, Gemini, or any AI tool
+- Structured, compressed, AI-ready context
+- No fluff, no generic explanations
+
+---
+
+##  Project Structure
+
+```
+devmem/
+├── src/
+│   ├── index.ts              # CLI entry point
+│   ├── commands/
+│   │   ├── setup.ts           # Interactive provider config
+│   │   └── generate.ts        # Scan + AI context generation
+│   └── utils/
+│       ├── config.ts           # ~/.devmem/config.json management
+│       ├── scanner.ts          # File discovery & folder grouping
+│       ├── ai.ts               # Multi-provider AI client
+│       └── prompts.ts          # Dynamic prompt generation
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+## License
+
+MIT

package/dist/commands/generate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerGenerateCommand(program: Command): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuG9D"}

package/dist/commands/generate.js

@@ -0,0 +1,105 @@
+import path from 'path';
+import fs from 'fs-extra';
+import pc from 'picocolors';
+import ora from 'ora';
+import { loadConfig } from '../utils/config.js';
+import { createAIClient } from '../utils/ai.js';
+import { scanProjectByFolders, getAllFiles, filterByTargets, } from '../utils/scanner.js';
+import { buildFolderPrompt, buildTargetedPrompt } from '../utils/prompts.js';
+function formatFileContents(files) {
+    if (files.length === 0)
+        return '';
+    return files
+        .map((f) => `### ${f.relativePath}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join('\n\n');
+}
+export function registerGenerateCommand(program) {
+    program
+        .command('generate')
+        .description('Scan codebase and generate context files')
+        .option('-o, --output <dir>', 'Output directory', '.dev')
+        .option('--only <targets>', 'Generate only for specific folders, subfolders, or files (comma-separated)')
+        .action(async (options) => {
+        const projectDir = process.cwd();
+        const outputDir = path.resolve(projectDir, options.output);
+        // Load config
+        let config;
+        try {
+            config = await loadConfig();
+        }
+        catch (err) {
+            console.log(pc.red(`\n  ✗ ${err.message}\n`));
+            process.exit(1);
+        }
+        console.log();
+        console.log(pc.bold('  🧠 DevMem Generate'));
+        console.log(pc.dim('  ─────────────────────'));
+        console.log(pc.dim(`  Provider: ${config.provider} | Model: ${config.model}`));
+        console.log();
+        // Step 1: Scan full project
+        const scanSpinner = ora({ text: '  Scanning project...', indent: 2 }).start();
+        const fullScan = await scanProjectByFolders(projectDir);
+        const allFiles = getAllFiles(fullScan);
+        const folderNames = Object.keys(fullScan);
+        if (allFiles.length === 0) {
+            scanSpinner.fail('  No relevant files found.');
+            console.log(pc.dim('  Make sure you are in the root of a project.\n'));
+            return;
+        }
+        // Determine what to generate
+        const isTargeted = !!options.only;
+        let targetsToGenerate;
+        if (isTargeted) {
+            const targets = options.only.split(',').map((t) => t.trim());
+            targetsToGenerate = filterByTargets(fullScan, targets);
+            if (Object.keys(targetsToGenerate).length === 0) {
+                scanSpinner.fail('  No matching targets found.');
+                console.log(pc.dim(`  Available folders: ${folderNames.join(', ')}\n`));
+                return;
+            }
+            const targetKeys = Object.keys(targetsToGenerate);
+            const targetFileCount = Object.values(targetsToGenerate).flat().length;
+            scanSpinner.succeed(`  Found ${pc.cyan(String(allFiles.length))} total files | Targeting: ${targetKeys.map((t) => pc.yellow(t)).join(', ')} (${targetFileCount} files)`);
+        }
+        else {
+            targetsToGenerate = fullScan;
+            const folderSummary = folderNames
+                .map((f) => `${f}: ${fullScan[f].length}`)
+                .join(', ');
+            scanSpinner.succeed(`  Found ${pc.cyan(String(allFiles.length))} files across ${pc.cyan(String(folderNames.length))} folders — ${folderSummary}`);
+        }
+        // Step 2: Generate with AI
+        const ai = createAIClient(config);
+        await fs.ensureDir(outputDir);
+        // Full project context (used for targeted generation)
+        const fullContext = formatFileContents(allFiles);
+        for (const [folderKey, files] of Object.entries(targetsToGenerate)) {
+            const spinner = ora({ text: `  Generating ${pc.cyan(folderKey)} context...`, indent: 2 }).start();
+            try {
+                let prompt;
+                let context;
+                if (isTargeted) {
+                    // Targeted: send FULL project as context, but prompt asks for specific target only
+                    prompt = buildTargetedPrompt(folderKey);
+                    context = fullContext;
+                }
+                else {
+                    // Full scan: send only the folder's files
+                    prompt = buildFolderPrompt(folderKey);
+                    context = formatFileContents(files);
+                }
+                const result = await ai.summarize(prompt, context);
+                const outPath = path.join(outputDir, `${folderKey}.md`);
+                await fs.writeFile(outPath, result, 'utf-8');
+                spinner.succeed(`  ${folderKey} → ${pc.green(path.relative(projectDir, outPath))}`);
+            }
+            catch (err) {
+                spinner.fail(`  ${folderKey} failed: ${err.message}`);
+            }
+        }
+        console.log();
+        console.log(pc.green(pc.bold('  ✓ Context files generated!')));
+        console.log(pc.dim(`  Output: ${path.relative(projectDir, outputDir)}/\n`));
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSetupCommand(program: Command): void;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0F3D"}

package/dist/commands/setup.js

@@ -0,0 +1,96 @@
+import readline from 'readline';
+import pc from 'picocolors';
+import { saveConfig, loadConfig, maskKey, DEFAULT_MODELS } from '../utils/config.js';
+function createRL() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+export function registerSetupCommand(program) {
+    program
+        .command('setup')
+        .description('Configure your AI provider and API key')
+        .option('--show', 'Show current configuration')
+        .option('--remove', 'Remove current configuration and API key')
+        .action(async (options) => {
+        if (options.remove) {
+            try {
+                await import('../utils/config.js').then(m => m.removeConfig());
+                console.log(pc.green('\n  ✓ Configuration and API key removed successfully.\n'));
+            }
+            catch (err) {
+                console.log(pc.red(`\n  ✗ Failed to remove configuration: ${err.message}\n`));
+            }
+            return;
+        }
+        if (options.show) {
+            try {
+                const config = await loadConfig();
+                console.log();
+                console.log(pc.bold('  DevMem Configuration'));
+                console.log(pc.dim('  ─────────────────────'));
+                console.log(`  Provider : ${pc.cyan(config.provider)}`);
+                console.log(`  Model    : ${pc.cyan(config.model)}`);
+                console.log(`  API Key  : ${pc.yellow(maskKey(config.apiKey))}`);
+                console.log();
+            }
+            catch {
+                console.log(pc.red('\n  ✗ No configuration found. Run `devmem setup` first.\n'));
+            }
+            return;
+        }
+        const rl = createRL();
+        try {
+            console.log();
+            console.log(pc.bold('  🧠 DevMem Setup'));
+            console.log(pc.dim('  ─────────────────'));
+            console.log();
+            // 1. Choose provider
+            console.log(pc.dim('  Available providers:'));
+            console.log(`    ${pc.cyan('1')} — Gemini`);
+            console.log(`    ${pc.cyan('2')} — OpenAI`);
+            console.log(`    ${pc.cyan('3')} — Anthropic`);
+            console.log();
+            let providerChoice = '';
+            while (!['1', '2', '3'].includes(providerChoice)) {
+                providerChoice = await ask(rl, pc.bold('  Select provider (1/2/3): '));
+            }
+            const providerMap = {
+                '1': 'gemini',
+                '2': 'openai',
+                '3': 'anthropic',
+            };
+            const provider = providerMap[providerChoice];
+            // 2. Enter API key
+            console.log();
+            const apiKey = await ask(rl, pc.bold(`  Enter your ${provider} API key: `));
+            if (!apiKey) {
+                console.log(pc.red('\n  ✗ API key cannot be empty.\n'));
+                rl.close();
+                return;
+            }
+            // 3. Choose model
+            const defaultModel = DEFAULT_MODELS[provider];
+            console.log();
+            const modelInput = await ask(rl, pc.bold(`  Model ${pc.dim(`(default: ${defaultModel})`)}: `));
+            const model = modelInput || defaultModel;
+            // Save
+            const config = { provider, apiKey, model };
+            await saveConfig(config);
+            console.log();
+            console.log(pc.green('  ✓ Configuration saved!'));
+            console.log(pc.dim(`  Provider: ${provider} | Model: ${model}`));
+            console.log();
+        }
+        finally {
+            rl.close();
+        }
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerSetupCommand } from './commands/setup.js';
+import { registerGenerateCommand } from './commands/generate.js';
+const program = new Command();
+program
+    .name('devmem')
+    .description('Generate persistent, domain-specific context files for AI tools')
+    .version('1.0.0');
+registerSetupCommand(program);
+registerGenerateCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,iEAAiE,CAAC;KAC9E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/ai.d.ts

@@ -0,0 +1,6 @@
+import { DevMemConfig } from './config.js';
+export interface AIClient {
+    summarize(prompt: string, fileContents: string): Promise<string>;
+}
+export declare function createAIClient(config: DevMemConfig): AIClient;
+//# sourceMappingURL=ai.d.ts.map

package/dist/utils/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/utils/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAwDD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAW7D"}

package/dist/utils/ai.js

@@ -0,0 +1,65 @@
+import { GoogleGenerativeAI } from '@google/generative-ai';
+import OpenAI from 'openai';
+import Anthropic from '@anthropic-ai/sdk';
+import { SYSTEM_PROMPT } from './prompts.js';
+function createGeminiClient(config) {
+    const genAI = new GoogleGenerativeAI(config.apiKey);
+    const model = genAI.getGenerativeModel({ model: config.model });
+    return {
+        async summarize(prompt, fileContents) {
+            const result = await model.generateContent([
+                { text: SYSTEM_PROMPT },
+                { text: prompt },
+                { text: `\n\n--- SOURCE FILES ---\n\n${fileContents}` },
+            ]);
+            return result.response.text();
+        },
+    };
+}
+function createOpenAIClient(config) {
+    const client = new OpenAI({ apiKey: config.apiKey });
+    return {
+        async summarize(prompt, fileContents) {
+            const response = await client.chat.completions.create({
+                model: config.model,
+                messages: [
+                    { role: 'system', content: SYSTEM_PROMPT },
+                    { role: 'user', content: `${prompt}\n\n--- SOURCE FILES ---\n\n${fileContents}` },
+                ],
+                temperature: 0.3,
+                max_tokens: 4096,
+            });
+            return response.choices[0]?.message?.content ?? '';
+        },
+    };
+}
+function createAnthropicClient(config) {
+    const client = new Anthropic({ apiKey: config.apiKey });
+    return {
+        async summarize(prompt, fileContents) {
+            const response = await client.messages.create({
+                model: config.model,
+                max_tokens: 4096,
+                system: SYSTEM_PROMPT,
+                messages: [
+                    { role: 'user', content: `${prompt}\n\n--- SOURCE FILES ---\n\n${fileContents}` },
+                ],
+            });
+            const block = response.content[0];
+            return block.type === 'text' ? block.text : '';
+        },
+    };
+}
+export function createAIClient(config) {
+    switch (config.provider) {
+        case 'gemini':
+            return createGeminiClient(config);
+        case 'openai':
+            return createOpenAIClient(config);
+        case 'anthropic':
+            return createAnthropicClient(config);
+        default:
+            throw new Error(`Unsupported provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/utils/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/utils/ai.ts"],"names":[],"mappings":"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"}

package/dist/utils/config.d.ts

@@ -0,0 +1,12 @@
+export interface DevMemConfig {
+    provider: 'gemini' | 'openai' | 'anthropic';
+    apiKey: string;
+    model: string;
+}
+export declare function getConfigPath(): string;
+export declare function loadConfig(): Promise<DevMemConfig>;
+export declare function saveConfig(config: DevMemConfig): Promise<void>;
+export declare function removeConfig(): Promise<void>;
+export declare function maskKey(key: string): string;
+export declare const DEFAULT_MODELS: Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAGD,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAiBxD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIjD,CAAC"}

package/dist/utils/config.js

@@ -0,0 +1,37 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+const CONFIG_DIR = path.join(os.homedir(), '.devmem');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export async function loadConfig() {
+    const exists = await fs.pathExists(CONFIG_FILE);
+    if (!exists) {
+        throw new Error('DevMem is not configured yet. Run `devmem setup` first.');
+    }
+    const raw = await fs.readJSON(CONFIG_FILE);
+    if (!raw.provider || !raw.apiKey) {
+        throw new Error('Invalid config. Run `devmem setup` to reconfigure.');
+    }
+    return raw;
+}
+export async function saveConfig(config) {
+    await fs.ensureDir(CONFIG_DIR);
+    await fs.writeJSON(CONFIG_FILE, config, { spaces: 2 });
+}
+export async function removeConfig() {
+    await fs.remove(CONFIG_FILE);
+}
+export function maskKey(key) {
+    if (key.length <= 8)
+        return '****';
+    return key.slice(0, 4) + '...' + key.slice(-4);
+}
+export const DEFAULT_MODELS = {
+    gemini: 'gemini-2.0-flash',
+    openai: 'gpt-4o-mini',
+    anthropic: 'claude-3-5-haiku-latest',
+};
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAQpB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE3C,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,GAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,yBAAyB;CACrC,CAAC"}

package/dist/utils/prompts.d.ts

@@ -0,0 +1,11 @@
+export declare const SYSTEM_PROMPT = "You are DevMem, a context extraction engine. Your job is to analyze source code and produce structured, concise, AI-ready context documentation.\n\nRules:\n- Include only high-signal information: architecture, patterns, structure, conventions\n- Preserve actual project decisions \u2014 do not assume or generalize beyond the codebase\n- Optimize for AI usage: concise, structured, no fluff\n- Prefer bullet points\n- Keep output concise enough to fit in an LLM context window\n- Do NOT generate code\n- Do NOT hallucinate missing details\n- Do NOT include low-value information";
+/**
+ * Build a context-generation prompt for a specific folder/target.
+ */
+export declare function buildFolderPrompt(folderName: string): string;
+/**
+ * Build a prompt that provides full project context but asks to generate
+ * documentation only for a specific target (folder, subfolder, or file).
+ */
+export declare function buildTargetedPrompt(targetName: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,ukBAUa,CAAC;AAExC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAmB9D"}

package/dist/utils/prompts.js

@@ -0,0 +1,60 @@
+export const SYSTEM_PROMPT = `You are DevMem, a context extraction engine. Your job is to analyze source code and produce structured, concise, AI-ready context documentation.
+
+Rules:
+- Include only high-signal information: architecture, patterns, structure, conventions
+- Preserve actual project decisions — do not assume or generalize beyond the codebase
+- Optimize for AI usage: concise, structured, no fluff
+- Prefer bullet points
+- Keep output concise enough to fit in an LLM context window
+- Do NOT generate code
+- Do NOT hallucinate missing details
+- Do NOT include low-value information`;
+/**
+ * Build a context-generation prompt for a specific folder/target.
+ */
+export function buildFolderPrompt(folderName) {
+    return `Analyze the following source files from the "${folderName}" part of the project and generate a structured context document.
+
+Include:
+- Tech stack and frameworks used in this area
+- Folder structure overview
+- Key patterns and conventions
+- Important modules/components and their responsibilities
+- How this area connects to other parts of the project
+- Any notable design decisions or constraints
+
+Avoid:
+- Trivial descriptions
+- Listing every single file
+- Generic explanations not specific to this codebase
+
+Output a clean markdown document titled "# ${capitalize(folderName)} Context".`;
+}
+/**
+ * Build a prompt that provides full project context but asks to generate
+ * documentation only for a specific target (folder, subfolder, or file).
+ */
+export function buildTargetedPrompt(targetName) {
+    return `You are given the FULL project source code for context. However, generate documentation ONLY for the "${targetName}" part of the project.
+
+Use the full codebase to understand relationships, dependencies, imports, and how this area fits into the bigger picture, but ONLY document "${targetName}".
+
+Include:
+- Tech stack and frameworks used in this specific area
+- Structure overview
+- Key patterns and conventions
+- Important modules/components and their responsibilities
+- How this area connects to other parts of the project
+- Dependencies and relationships with other parts of the codebase
+
+Avoid:
+- Documenting parts of the project outside "${targetName}"
+- Trivial descriptions
+- Generic explanations not specific to this codebase
+
+Output a clean markdown document titled "# ${capitalize(targetName)} Context".`;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;uCAUU,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,gDAAgD,UAAU;;;;;;;;;;;;;;;6CAetB,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,yGAAyG,UAAU;;+IAEmB,UAAU;;;;;;;;;;;8CAW3G,UAAU;;;;6CAIX,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC;AAChF,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/scanner.d.ts

@@ -0,0 +1,21 @@
+export interface FileEntry {
+    relativePath: string;
+    content: string;
+}
+/** Map of folder name → files in that folder */
+export type FolderScanResult = Record<string, FileEntry[]>;
+/**
+ * Scan a project and group files by their top-level folder.
+ * Root-level files are grouped under "root".
+ */
+export declare function scanProjectByFolders(projectDir: string): Promise<FolderScanResult>;
+/**
+ * Get all files from a FolderScanResult as a flat list.
+ */
+export declare function getAllFiles(scan: FolderScanResult): FileEntry[];
+/**
+ * Filter a scan result to only include specific targets.
+ * Targets can be top-level folder names, subfolder paths, or file paths.
+ */
+export declare function filterByTargets(scan: FolderScanResult, targets: string[]): FolderScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/utils/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/utils/scanner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AA8B3D;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsCxF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAAE,CAE/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EAAE,GAChB,gBAAgB,CAmClB"}

package/dist/utils/scanner.js

@@ -0,0 +1,106 @@
+import { glob } from 'glob';
+import fs from 'fs-extra';
+import path from 'path';
+const IGNORE_PATTERNS = [
+    'node_modules/**',
+    'dist/**',
+    'build/**',
+    '.next/**',
+    '.git/**',
+    '.dev/**',
+    '*.lock',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    '*.map',
+    '*.min.*',
+    '.env',
+    '.env.*',
+    '!.env.example',
+];
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.webp',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.mp4', '.webm', '.mp3', '.wav', '.ogg',
+    '.pdf', '.zip', '.tar', '.gz', '.bz2',
+    '.exe', '.dll', '.so', '.dylib',
+]);
+const MAX_FILE_SIZE = 50 * 1024; // 50KB
+/**
+ * Scan a project and group files by their top-level folder.
+ * Root-level files are grouped under "root".
+ */
+export async function scanProjectByFolders(projectDir) {
+    const files = await glob('**/*', {
+        cwd: projectDir,
+        nodir: true,
+        ignore: IGNORE_PATTERNS,
+        dot: false,
+    });
+    const result = {};
+    for (const file of files) {
+        const absPath = path.join(projectDir, file);
+        // Skip large files
+        const stat = await fs.stat(absPath);
+        if (stat.size > MAX_FILE_SIZE)
+            continue;
+        // Skip binary files
+        const ext = path.extname(file).toLowerCase();
+        if (BINARY_EXTENSIONS.has(ext))
+            continue;
+        // Determine the top-level folder (or "root")
+        const parts = file.split(path.sep);
+        const folderKey = parts.length > 1 ? parts[0] : 'root';
+        try {
+            const content = await fs.readFile(absPath, 'utf-8');
+            if (!result[folderKey]) {
+                result[folderKey] = [];
+            }
+            result[folderKey].push({ relativePath: file, content });
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return result;
+}
+/**
+ * Get all files from a FolderScanResult as a flat list.
+ */
+export function getAllFiles(scan) {
+    return Object.values(scan).flat();
+}
+/**
+ * Filter a scan result to only include specific targets.
+ * Targets can be top-level folder names, subfolder paths, or file paths.
+ */
+export function filterByTargets(scan, targets) {
+    const filtered = {};
+    for (const target of targets) {
+        const normalizedTarget = target.replace(/\/$/, ''); // remove trailing slash
+        // 1. Exact top-level folder match
+        if (scan[normalizedTarget]) {
+            filtered[normalizedTarget] = scan[normalizedTarget];
+            continue;
+        }
+        // 2. Subfolder or file match — search across all folders
+        for (const [folder, files] of Object.entries(scan)) {
+            const matching = files.filter((f) => {
+                // Match if the file path starts with the target (subfolder)
+                // or equals the target (exact file)
+                return (f.relativePath === normalizedTarget ||
+                    f.relativePath.startsWith(normalizedTarget + '/'));
+            });
+            if (matching.length > 0) {
+                // Use the target as the key for the output file name
+                const key = normalizedTarget.replace(/\//g, '-');
+                if (!filtered[key]) {
+                    filtered[key] = [];
+                }
+                filtered[key].push(...matching);
+            }
+        }
+    }
+    return filtered;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/utils/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/utils/scanner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "devmem",
+  "version": "1.0.0",
+  "description": "CLI tool that scans a codebase and generates persistent, domain-specific context files for AI tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "devmem": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "context",
+    "devmem",
+    "llm",
+    "developer-tools",
+    "codebase-analysis"
+  ],
+  "author": "nikhildhaliya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NikhilDhaliya/devmem.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NikhilDhaliya/devmem/issues"
+  },
+  "homepage": "https://github.com/NikhilDhaliya/devmem#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@google/generative-ai": "^0.24.1",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.4",
+    "glob": "^13.0.6",
+    "openai": "^6.33.0",
+    "ora": "^9.3.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}