aidx 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 rx76d
+
+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/dist/index.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { checkbox, confirm } from '@inquirer/prompts';
+import glob from 'fast-glob';
+import fs from 'fs/promises';
+import { statSync } from 'fs';
+import path from 'path';
+import clipboardy from 'clipboardy';
+import chalk from 'chalk';
+import { encode } from 'gpt-tokenizer';
+import * as Diff from 'diff';
+import { isBinaryFile } from 'isbinaryfile';
+// --- CONFIGURATION ---
+const METADATA = {
+    name: "aidx",
+    description: "A CLI bridge between local code and LLMs.",
+    author: "rx76d",
+    version: "",
+    license: "MIT",
+    github: "https://github.com/rx76d/aidx"
+};
+const CONFIG_FILE = '.aidxrc.json';
+const MAX_FILE_SIZE = 1.5 * 1024 * 1024; // 1.5MB Limit
+const SECRET_REGEX = /(?:sk-[a-zA-Z0-9]{32,})|(?:AKIA[0-9A-Z]{16})|(?:[a-zA-Z0-9+/]{40,}=)/;
+const SYSTEM_HEADER = `
+================================================================
+SYSTEM PROMPT: STRICT CODE MODE
+You are an automated coding agent. You are NOT a chatbot.
+You do NOT converse. You do NOT use Markdown formatting (like \`\`\`).
+You ONLY output executable XML code changes.
+================================================================
+`;
+const XML_SCHEMA_INSTRUCTION = `
+\n\n
+================================================================
+CRITICAL OUTPUT INSTRUCTIONS:
+1. You must output file changes inside <file> tags.
+2. The "path" attribute must match the file path exactly.
+3. **PROVIDE THE FULL FILE CONTENT.** Do not use placeholders like "// ... rest of code ...".
+4. Do NOT wrap the output in \`\`\`xml or \`\`\` blocks.
+
+FORMAT EXAMPLE:
+<file path="src/index.ts">
+import fs from 'fs';
+console.log("Full code here...");
+</file>
+================================================================
+`;
+// --- GLOBAL HANDLERS ---
+process.on('SIGINT', () => {
+    console.log(chalk.yellow('\n\nOperation cancelled by user.'));
+    process.exit(0);
+});
+// --- HELPER: CONFIG MANAGEMENT ---
+async function getBackupStatus() {
+    try {
+        const configPath = path.resolve(process.cwd(), CONFIG_FILE);
+        const data = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(data);
+        return !!config.backup;
+    }
+    catch (e) {
+        return false;
+    }
+}
+async function setBackupStatus(enabled) {
+    const configPath = path.resolve(process.cwd(), CONFIG_FILE);
+    await fs.writeFile(configPath, JSON.stringify({ backup: enabled }, null, 2));
+}
+const program = new Command();
+program
+    .name(METADATA.name)
+    .description(METADATA.description)
+    .version(METADATA.version);
+// --- ROOT COMMAND (DASHBOARD) ---
+program.action(async () => {
+    const backupEnabled = await getBackupStatus();
+    console.log('\n' + chalk.bgBlue.bold(` ${METADATA.name.toUpperCase()} `) + chalk.dim(` v${METADATA.version}`));
+    console.log(chalk.dim('----------------------------------------'));
+    console.log(`${chalk.bold('Description:')} ${METADATA.description}`);
+    console.log(`${chalk.bold('Author:')}      ${METADATA.author}`);
+    console.log(`${chalk.bold('Backups:')}     ${backupEnabled ? chalk.green('ENABLED') : chalk.dim('DISABLED')}`);
+    console.log(`${chalk.bold('Limit:')}       1.5MB per file`);
+    console.log(chalk.dim('----------------------------------------'));
+    console.log('\nAvailable Commands:');
+    console.log(`  ${chalk.cyan('npx aidx copy')}         Select files and copy context`);
+    console.log(`  ${chalk.cyan('npx aidx apply')}        Apply AI changes to disk`);
+    console.log(`  ${chalk.cyan('npx aidx backup --on')}  Enable auto-backups`);
+    console.log(`  ${chalk.cyan('npx aidx backup --off')}  Disable auto-backups`);
+    console.log(`  ${chalk.cyan('npx aidx stl')}          Show AI token limits`);
+    console.log(`\nRun ${chalk.gray('npx aidx --help')} for details.\n`);
+});
+// --- COMMAND: STL (Safe Token Limits) ---
+program
+    .command('stl')
+    .description('Show safe token limits for AI models')
+    .action(() => {
+    console.log('\n' + chalk.bold('AI Model Context Limits (2025 Reference)'));
+    console.log(chalk.dim('--------------------------------------------------'));
+    const models = [
+        { name: "Gemini 3 Pro", limit: "2,000,000+", type: "Huge" },
+        { name: "Gemini 2.5 Flash", limit: "1,000,000+", type: "Huge" },
+        { name: "ChatGPT-5", limit: "  200,000", type: "Large" },
+        { name: "Claude 4.5 Sonnet", limit: "  200,000", type: "Large" },
+        { name: "GPT-4o", limit: "  128,000", type: "Medium" },
+        { name: "Llama 4 405B", limit: "  128,000", type: "Medium" },
+        { name: "DeepSeek V3", limit: "  128,000", type: "Medium" },
+        { name: "ChatGPT (Free)", limit: "   ~8,000", type: "Small" },
+    ];
+    console.log(chalk.cyan('Model Name'.padEnd(20)) + chalk.yellow('Max Tokens'.padEnd(15)) + chalk.white('Category'));
+    console.log(chalk.dim('--------------------------------------------------'));
+    models.forEach(m => {
+        const color = m.type === "Huge" ? chalk.green : m.type === "Large" ? chalk.blue : chalk.gray;
+        console.log(m.name.padEnd(20) + color(m.limit.padEnd(15)) + chalk.dim(m.type));
+    });
+    console.log(chalk.dim('--------------------------------------------------'));
+    console.log(chalk.dim('* 1,000 tokens ≈ 750 words of code/text.'));
+    console.log(chalk.dim('* Estimates based on latest model specs.\n'));
+});
+// --- COMMAND: BACKUP ---
+program
+    .command('backup')
+    .description('Configure automatic backups')
+    .option('--on', 'Enable backups')
+    .option('--off', 'Disable backups')
+    .action(async (options) => {
+    if (options.on) {
+        await setBackupStatus(true);
+        console.log(chalk.green(`\n✔ Backups enabled. Settings saved to ${CONFIG_FILE}`));
+    }
+    else if (options.off) {
+        await setBackupStatus(false);
+        console.log(chalk.yellow(`\nBackups disabled.`));
+    }
+    else {
+        const status = await getBackupStatus();
+        console.log(`\nCurrent Backup Status: ${status ? chalk.green('ENABLED') : chalk.red('DISABLED')}`);
+    }
+});
+// --- COMMAND: COPY (ROBUST) ---
+program
+    .command('copy')
+    .description('Select files and copy to clipboard')
+    .action(async () => {
+    console.log(chalk.blue('Scanning directory...'));
+    const files = await glob(['**/*'], {
+        ignore: [
+            // Windows System Junk (CRITICAL FOR STABILITY)
+            '**/Application Data/**', '**/Cookies/**', '**/Local Settings/**', '**/Recent/**', '**/Start Menu/**',
+            // Dev Junk
+            '**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**', '**/.vscode/**',
+            '**/__pycache__/**', '**/venv/**', '**/target/**', '**/bin/**', '**/obj/**',
+            '**/vendor/**',
+            // File Types
+            '**/*.lock', '**/*.log', '**/*.png', '**/*.exe', '**/*.dll', '**/*.zip', '**/*.tar', '**/*.gz'
+        ],
+        onlyFiles: true,
+        dot: true,
+        suppressErrors: true, // Fixes Windows EPERM crashes
+        followSymbolicLinks: false // Fixes Infinite Loops
+    });
+    if (files.length === 0)
+        return console.log(chalk.red('Error: No files found.'));
+    let selectedFiles = [];
+    try {
+        selectedFiles = await checkbox({
+            message: 'Select files to send to AI:',
+            choices: files.map(f => ({ name: f, value: f })),
+            pageSize: 15, loop: false,
+        });
+    }
+    catch (e) {
+        return console.log(chalk.yellow('\nSelection cancelled.'));
+    }
+    if (selectedFiles.length === 0)
+        return console.log(chalk.yellow('No files selected.'));
+    let output = SYSTEM_HEADER + "\n";
+    let skippedCount = 0;
+    console.log(chalk.dim('Reading files...'));
+    for (const file of selectedFiles) {
+        try {
+            // 1. Check Size
+            const stats = statSync(file);
+            if (stats.size > MAX_FILE_SIZE) {
+                console.log(chalk.yellow(`⚠ Skipped large file (>1.5MB): ${file}`));
+                skippedCount++;
+                continue;
+            }
+            // 2. Check Binary
+            if (await isBinaryFile(file)) {
+                console.log(chalk.yellow(`⚠ Skipped binary file: ${file}`));
+                skippedCount++;
+                continue;
+            }
+            const content = await fs.readFile(file, 'utf-8');
+            // 3. Check Secrets
+            if (file.includes('.env') || SECRET_REGEX.test(content)) {
+                console.log(chalk.red(`\nSECURITY ALERT: Secrets detected in ${file}`));
+                skippedCount++;
+                continue;
+            }
+            output += `File: ${file}\n\`\`\`\n${content}\n\`\`\`\n\n`;
+        }
+        catch (e) {
+            console.log(chalk.red(`Error reading ${file}`));
+        }
+    }
+    output += XML_SCHEMA_INSTRUCTION;
+    try {
+        await clipboardy.write(output);
+        const tokens = encode(output).length;
+        const finalCount = selectedFiles.length - skippedCount;
+        const tokenColor = tokens > 100000 ? chalk.red : tokens > 30000 ? chalk.yellow : chalk.green;
+        console.log(chalk.green(`\n✔ Copied ${finalCount} files to clipboard`));
+        console.log(`Estimated Tokens: ${tokenColor(tokens.toLocaleString())}`);
+    }
+    catch (e) {
+        console.log(chalk.red('Clipboard write failed (File too large for OS).'));
+        console.log(chalk.dim('Try selecting fewer files.'));
+    }
+});
+// --- COMMAND: APPLY ---
+program
+    .command('apply')
+    .description('Apply AI changes from clipboard')
+    .action(async () => {
+    const backupsEnabled = await getBackupStatus();
+    console.log(chalk.dim('Reading clipboard...'));
+    let content;
+    try {
+        content = await clipboardy.read();
+    }
+    catch (e) {
+        return console.log(chalk.red('Error: Could not read clipboard.'));
+    }
+    const cleanedContent = content.replace(/```xml/g, '').replace(/```/g, '');
+    const fileRegex = /<file\s+path=["'](.*?)["']\s*>([\s\S]*?)<\/file>/gi;
+    const deleteRegex = /<delete\s+path=["'](.*?)["']\s*\/>/gi;
+    const updates = [];
+    let match;
+    while ((match = fileRegex.exec(cleanedContent)) !== null)
+        updates.push({ type: 'write', path: match[1], content: match[2].trim() });
+    while ((match = deleteRegex.exec(cleanedContent)) !== null)
+        updates.push({ type: 'delete', path: match[1] });
+    if (updates.length === 0)
+        return console.log(chalk.red('\nNo valid XML tags found.'));
+    console.log(chalk.bold(`\nFound ${updates.length} pending change(s):\n`));
+    for (const update of updates) {
+        const targetPath = path.resolve(process.cwd(), update.path);
+        console.log(chalk.bgBlue.white(` ${update.path} `));
+        if (update.type === 'delete') {
+            console.log(chalk.bgRed.white(' [DELETE] '));
+        }
+        else {
+            let originalContent = '';
+            try {
+                originalContent = await fs.readFile(targetPath, 'utf-8');
+            }
+            catch (e) {
+                console.log(chalk.bgGreen.black(' [NEW FILE] '));
+            }
+            if (originalContent && update.content !== undefined) {
+                const changes = Diff.diffLines(originalContent, update.content);
+                let count = 0;
+                changes.forEach((part) => {
+                    if (count > 50)
+                        return;
+                    if (part.added) {
+                        process.stdout.write(chalk.green(part.value.replace(/^/gm, '+ ')));
+                        count++;
+                    }
+                    else if (part.removed) {
+                        process.stdout.write(chalk.red(part.value.replace(/^/gm, '- ')));
+                        count++;
+                    }
+                });
+                if (count > 50)
+                    console.log(chalk.dim('...'));
+                console.log('');
+            }
+        }
+        console.log(chalk.dim('--------------------------------------------------\n'));
+    }
+    let proceed = false;
+    try {
+        proceed = await confirm({ message: 'Apply these changes to disk?' });
+    }
+    catch (e) {
+        return;
+    }
+    if (!proceed)
+        return console.log(chalk.yellow('Aborted.'));
+    console.log('');
+    for (const update of updates) {
+        const targetPath = path.resolve(process.cwd(), update.path);
+        try {
+            if (update.type === 'delete') {
+                if (backupsEnabled) {
+                    try {
+                        await fs.copyFile(targetPath, `${targetPath}.bak`);
+                    }
+                    catch (e) { }
+                }
+                try {
+                    await fs.unlink(targetPath);
+                    console.log(chalk.gray(`Deleted ${update.path}`));
+                }
+                catch (e) { }
+            }
+            else {
+                await fs.mkdir(path.dirname(targetPath), { recursive: true });
+                if (backupsEnabled) {
+                    try {
+                        await fs.copyFile(targetPath, `${targetPath}.bak`);
+                        console.log(chalk.gray(`(Backup saved)`));
+                    }
+                    catch (e) { }
+                }
+                await fs.writeFile(targetPath, update.content || '');
+                console.log(chalk.green(`✔ Wrote ${update.path}`));
+            }
+        }
+        catch (e) {
+            console.log(chalk.bgRed.white(` ERROR `) + ` ${update.path}: ${e.message}`);
+        }
+    }
+    console.log(chalk.cyan('\nDone.'));
+});
+program.on('command:*', (operands) => {
+    console.error(chalk.red(`\nError: Unknown command '${operands[0]}'`));
+    process.exit(1);
+});
+program.parse();

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "aidx",
+  "version": "1.0.1",
+  "description": "A CLI bridge between local code and LLMs. Copy context to clipboard and apply AI changes safely with diffs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "aidx": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "tsx src/index.ts",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rx76d/aidx.git"
+  },
+  "homepage": "https://github.com/rx76d/aidx#readme",
+  "bugs": {
+    "url": "https://github.com/rx76d/aidx/issues"
+  },
+  "keywords": [
+    "aidx",
+    "rx76d",
+    "ai",
+    "cli",
+    "clipboard",
+    "workflow",
+    "automation",
+    "llm",
+    "chatgpt",
+    "claude",
+    "context",
+    "diff"
+  ],
+  "author": "rx76d",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "clipboardy": "^4.0.0",
+    "commander": "^12.0.0",
+    "diff": "^5.2.0",
+    "fast-glob": "^3.3.2",
+    "gpt-tokenizer": "^2.1.2",
+    "isbinaryfile": "^5.0.2"
+  },
+  "devDependencies": {
+    "@types/diff": "^5.0.9",
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,115 @@
+<div align="center">
+  
+  <h1>aidx</h1>
+
+  <p>
+    <strong>The CLI bridge between your local codebase and LLMs.</strong>
+  </p>
+
+  ![Version](https://img.shields.io/npm/v/aidx?style=flat-square&color=blue)
+  ![Status](https://img.shields.io/badge/status-Live-success.svg)
+  ![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)
+  ![Downloads](https://img.shields.io/npm/dt/aidx?style=flat-square&color=orange)
+
+  <br />
+
+  <p>
+    <a href="#-quick-start">Quick Start</a> •
+    <a href="#-how-it-works">How It Works</a> •
+    <a href="#-commands">Commands</a> •
+    <a href="#-features">Features</a>
+  </p>
+</div>
+
+---
+
+## 📖 About
+
+**aidx** is a zero-config tool that turns your terminal into a context manager for ChatGPT, Claude, and Gemini.
+
+It solves two problems:
+1.  **Getting code TO the AI:** It scans your project, filters out junk (binaries, secrets, `node_modules`), and copies code to your clipboard with a strict XML protocol.
+2.  **Getting code FROM the AI:** It reads the AI's response, shows you a visual diff, and applies changes to your disk safely.
+
+---
+
+## 🚀 Quick Start
+
+No installation required. Run it instantly:
+
+```bash
+npx aidx
+```
+
+Or install globally for repeated use:
+```bash
+npm install -g aidx
+```
+
+## 🔄 How It Works
+1. **The Outbound Loop (Copying)**
+
+Select the files you want the AI to understand.
+```
+npx aidx copy
+```
+
+**Action:** Opens an interactive file picker.
+Result: Copies files + hidden system instructions to your clipboard.
+Next: Paste into ChatGPT/Claude.
+
+2. **The Inbound Loop (Applying):**
+When the AI replies with code, copy its entire response to your clipboard.
+```
+npx aidx apply
+```
+**Action:** Scans your clipboard for the XML tags.
+**Safety:** Shows a Git-style diff (Green + / Red -).
+**Result:** Updates your files only after you confirm Yes.
+
+
+# 🎮 Commands
+
+Command	Description
+
+```npx aidx```:	Shows the main menu and status info.
+
+```npx aidx copy```: Interactive file scanner & clipboard copier.
+
+```npx aidx apply```:	Reads clipboard, shows diffs, and writes changes.
+
+```npx aidx backup --on```:	Enables automatic .bak files before overwriting.
+
+```npx aidx backup --off```:	Disables automatic backups.
+
+```npx aidx stl```: Shows token limits of AI model.
+
+```npx aidx --help```:	Displays help information.
+
+```npx aidx -version```:	Displays current version.
+
+# ✨ Features
+
+🛡️ **Security Guard**
+Automatically detects and blocks API keys (AWS, OpenAI, Stripe) from being copied to the clipboard. If a file looks like a secret, it is skipped.
+
+💾 **Automatic Backups**
+Don't trust the AI completely? Turn on backups.
+```npx aidx backup --on```
+Before src/App.tsx is updated, aidx will save a copy to src/App.tsx.bak.
+
+🌍 **Universal Support**
+Works with almost any text-based language:
+Web: TS, JS, HTML, CSS, Svelte, Vue, JSX
+Backend: Python, Go, Rust, Java, C#, PHP
+Config: JSON, YAML, TOML, SQL, Markdown
+Smart Ignores: Automatically ignores node_modules, .git, __pycache__, venv, target, bin, and binary files (.png, .exe).
+
+📊 **Token Awareness**
+Calculates estimated token usage before you paste, so you know if you are about to exceed the limits of GPT-5 or Claude 3.5.
+
+🛡️ **License**
+This project is open source and available under the MIT License.
+<div align="center">
+<sub>Developed by rx76d</sub>
+</div>