{"_id":"@byrem6/ai-dev-tools","_rev":"6-226d73b68e6dcd96f56cfffa05c8df82","name":"@byrem6/ai-dev-tools","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@byrem6/ai-dev-tools","version":"1.0.0","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","_id":"@byrem6/ai-dev-tools@1.0.0","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"homepage":"https://github.com/your-username/ai-dev-tools#readme","bugs":{"url":"https://github.com/your-username/ai-dev-tools/issues"},"bin":{"adt":"bin/adt"},"dist":{"shasum":"aa5f34ce3c6b2e49a9e1a27d27d76b60502d0865","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-1.0.0.tgz","fileCount":284,"integrity":"sha512-3UqiTR/1YT3wS4lQXj1FHowryNWQN/ZtmXaWsBWOGRlnU+6ucVeWMJVtRRcP729jwX1rhA3LrpWSTtODIY36hA==","signatures":[{"sig":"MEUCIQD1NMrSQaPu5jTWIVG4LVOhMnVkqSM6+CYHRJoYdpuvQwIga+/EKuE+R5Wt33DGQVkQCecYjvSJ4AUWG3IAB+gkinY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1112824},"main":"dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"dac9ad3ee16cbce169777f9d6b3b3b69054c2a2e","scripts":{"dev":"tsc && npm run copy-templates && node dist/index.js","lint":"eslint src/**/*.ts --fix","test":"jest","build":"tsc && npm run copy-templates","watch":"tsc --watch","format":"prettier --write src/**/*.ts","validate":"npm run typecheck && npm run lint:check && npm test","typecheck":"tsc --noEmit","lint:check":"eslint src/**/*.ts","test:watch":"jest --watch","format:check":"prettier --check src/**/*.ts","test:coverage":"jest --coverage","copy-templates":"copyfiles -f src/templates/* dist/templates/","prepublishOnly":"npm run build"},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"repository":{"url":"git+https://github.com/your-username/ai-dev-tools.git","type":"git"},"_npmVersion":"11.8.0","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"glob":"^10.3.10","uuid":"^9.0.1","chalk":"^4.1.2","ignore":"^5.3.0","commander":"^11.1.0","fast-glob":"^3.3.2","@babel/types":"^7.29.0","@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.6","prettier":"^3.1.1","copyfiles":"^2.4.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/parser":"^6.17.0","@typescript-eslint/eslint-plugin":"^6.17.0"},"_npmOperationalInternal":{"tmp":"tmp/ai-dev-tools_1.0.0_1774025512393_0.087861642000999","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@byrem6/ai-dev-tools","version":"1.0.1","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","_id":"@byrem6/ai-dev-tools@1.0.1","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"bin":{"adt":"bin/adt"},"dist":{"shasum":"e68e4fbe0fc4a1cdac21f736e55fed0e8c44cbf5","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-1.0.1.tgz","fileCount":284,"integrity":"sha512-3NhC5V3U5YecjMdQcuJe8o0Ev5s2xj+DTBW5RKPMFjgUkCED5REV1eUQQEI/zxtXGH7CqehE8kD3vcQmghqyuQ==","signatures":[{"sig":"MEUCIHEMWPDVKDsQ43313STzidx5Okk7aYcF9ai4K1VhMnscAiEAvAXTUHly8P/fYBUedoWrzkOvkPZKvwljMyT7ACi5iN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1112816},"main":"dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"dac9ad3ee16cbce169777f9d6b3b3b69054c2a2e","scripts":{"dev":"tsc && npm run copy-templates && node dist/index.js","lint":"eslint src/**/*.ts --fix","test":"jest","build":"tsc && npm run copy-templates","watch":"tsc --watch","format":"prettier --write src/**/*.ts","validate":"npm run typecheck && npm run lint:check && npm test","typecheck":"tsc --noEmit","lint:check":"eslint src/**/*.ts","test:watch":"jest --watch","format:check":"prettier --check src/**/*.ts","test:coverage":"jest --coverage","copy-templates":"copyfiles -f src/templates/* dist/templates/","prepublishOnly":"npm run build"},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"repository":{"url":"git+https://github.com/byrem6/ai-dev-tools.git","type":"git"},"_npmVersion":"11.8.0","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"glob":"^10.3.10","uuid":"^9.0.1","chalk":"^4.1.2","ignore":"^5.3.0","commander":"^11.1.0","fast-glob":"^3.3.2","@babel/types":"^7.29.0","@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.6","prettier":"^3.1.1","copyfiles":"^2.4.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/parser":"^6.17.0","@typescript-eslint/eslint-plugin":"^6.17.0"},"_npmOperationalInternal":{"tmp":"tmp/ai-dev-tools_1.0.1_1774025707180_0.19443126763315477","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@byrem6/ai-dev-tools","version":"1.0.2","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","_id":"@byrem6/ai-dev-tools@1.0.2","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"bin":{"adt":"bin/adt"},"dist":{"shasum":"05823d10b4195270ae09fb579fbf8869a09b12eb","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-1.0.2.tgz","fileCount":284,"integrity":"sha512-BIVMXPmPNed31K7sOYTGQPxHUOSk1IuljiB+XD3T8/z4EVHzdOlnWhU56pU8oPSxz50AYIwl4tYqfmU5qgKH5w==","signatures":[{"sig":"MEUCIQCkFM7o5AVt5r/PX26UyxwmueDjxglIs8pEBoSAbCOSuwIgLHxKbO0PcVhRHuUZC0KnfiB8lAdZX/2F00R33EMda4g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1112848},"main":"dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d2cf3e7c0b1f6c40b32b368c5d3394e541539e26","scripts":{"dev":"tsc && npm run copy-templates && node dist/index.js","lint":"eslint src/**/*.ts --fix","test":"jest","build":"tsc && npm run copy-templates","watch":"tsc --watch","format":"prettier --write src/**/*.ts","validate":"npm run typecheck && npm run lint:check && npm test","typecheck":"tsc --noEmit","lint:check":"eslint src/**/*.ts","test:watch":"jest --watch","format:check":"prettier --check src/**/*.ts","test:coverage":"jest --coverage","copy-templates":"copyfiles -f src/templates/* dist/templates/","prepublishOnly":"npm run build"},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"repository":{"url":"git+https://github.com/byrem6/ai-dev-tools.git","type":"git"},"_npmVersion":"11.8.0","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"glob":"^10.3.10","uuid":"^9.0.1","chalk":"^4.1.2","ignore":"^5.3.0","commander":"^11.1.0","fast-glob":"^3.3.2","@babel/types":"^7.29.0","@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.6","prettier":"^3.1.1","copyfiles":"^2.4.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/parser":"^6.17.0","@typescript-eslint/eslint-plugin":"^6.17.0"},"_npmOperationalInternal":{"tmp":"tmp/ai-dev-tools_1.0.2_1774026478906_0.1364524552546662","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@byrem6/ai-dev-tools","version":"1.1.0","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity","documentation","pattern-matching","complexity-analysis","token-optimization"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","_id":"@byrem6/ai-dev-tools@1.1.0","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"bin":{"adt":"bin/adt"},"dist":{"shasum":"b81b3012c817f3d371bc0b6e9b7299a7afb8f44f","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-1.1.0.tgz","fileCount":308,"integrity":"sha512-1GgLru4C+kppmaI0S/6BOAjc3Wca17kOWBPZRd2TurD5B6sUYGE/uhAvE8EVZPn5BCDGzlR1Y4+8QMjTF6NRpA==","signatures":[{"sig":"MEQCIHffMgIOdohZ7vn9ROpEWsVUiMz+e+QTDr4pJJq7vFcjAiAYv3NfyuJDgzijH71IABhLw7P8MF8BWTELCn4S+F2Dzg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1203915},"main":"dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6b48355b8e003746ce9fd5f3f205df5f8b63d559","scripts":{"dev":"tsc && npm run copy-templates && node dist/index.js","lint":"eslint src/**/*.ts --fix","test":"jest","build":"tsc && npm run copy-templates","watch":"tsc --watch","format":"prettier --write src/**/*.ts","validate":"npm run typecheck && npm run lint:check && npm test","typecheck":"tsc --noEmit","lint:check":"eslint src/**/*.ts","test:watch":"jest --watch","format:check":"prettier --check src/**/*.ts","test:coverage":"jest --coverage","copy-templates":"copyfiles -f src/templates/* dist/templates/","prepublishOnly":"npm run build"},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"repository":{"url":"git+https://github.com/byrem6/ai-dev-tools.git","type":"git"},"_npmVersion":"11.8.0","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers with advanced doc analysis features","directories":{},"_nodeVersion":"25.5.0","dependencies":{"glob":"^10.3.10","uuid":"^9.0.1","chalk":"^4.1.2","ignore":"^5.3.0","commander":"^11.1.0","fast-glob":"^3.3.2","@babel/types":"^7.29.0","@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.6","prettier":"^3.1.1","copyfiles":"^2.4.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/parser":"^6.17.0","@typescript-eslint/eslint-plugin":"^6.17.0"},"_npmOperationalInternal":{"tmp":"tmp/ai-dev-tools_1.1.0_1774028251898_0.19142058860826672","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@byrem6/ai-dev-tools","version":"2.0.0","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity","documentation","pattern-matching","complexity-analysis","token-optimization"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","_id":"@byrem6/ai-dev-tools@2.0.0","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"bin":{"adt":"bin/adt"},"dist":{"shasum":"082c8371b97a795adc7301d6b361cb02d751ea29","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-2.0.0.tgz","fileCount":361,"integrity":"sha512-6D3mhwBzeWpRJaG5+48VFTQFCq/eqcfPWDza/QIrKUmqZiCMxey5oTToSiCDrRmxevvbH/wUf/Y2ok3ICjTEtw==","signatures":[{"sig":"MEUCIQC1JfKXGPmy7dtMiVIlc01/ZJk3M4aJtKGOKEW/Xf2qEAIgH5llGiS6mhyLl7lorx2ba7FuUlLiO1LwQC3D9fgbqyY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1596933},"main":"dist/index.js","type":"commonjs","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b4eae0d52c973661fc9db1081fb11b6f594fca30","scripts":{"dev":"tsc && npm run copy-templates && node dist/index.js","lint":"eslint src/**/*.ts --fix","test":"jest","build":"tsc && npm run copy-templates","watch":"tsc --watch","format":"prettier --write src/**/*.ts","validate":"npm run typecheck && npm run lint:check && npm test","typecheck":"tsc --noEmit","lint:check":"eslint src/**/*.ts","test:watch":"jest --watch","format:check":"prettier --check src/**/*.ts","test:coverage":"jest --coverage","copy-templates":"copyfiles -f src/templates/* dist/templates/ && copyfiles -f src/templates/commands/* dist/templates/commands/","prepublishOnly":"npm run build"},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"repository":{"url":"git+https://github.com/byrem6/ai-dev-tools.git","type":"git"},"_npmVersion":"11.8.0","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers with advanced doc analysis features","directories":{},"_nodeVersion":"25.5.0","dependencies":{"glob":"^10.3.10","uuid":"^9.0.1","chalk":"^4.1.2","ignore":"^5.3.0","commander":"^11.1.0","fast-glob":"^3.3.2","@babel/types":"^7.29.0","@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","ts-jest":"^29.4.6","prettier":"^3.1.1","copyfiles":"^2.4.1","typescript":"^5.3.3","@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/parser":"^6.17.0","@typescript-eslint/eslint-plugin":"^6.17.0"},"_npmOperationalInternal":{"tmp":"tmp/ai-dev-tools_2.0.0_1774079553009_0.8757802050154924","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@byrem6/ai-dev-tools","version":"2.0.1","description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers with advanced doc analysis features","main":"dist/index.js","bin":{"adt":"bin/adt"},"type":"commonjs","scripts":{"build":"tsc && npm run copy-templates","dev":"tsc && npm run copy-templates && node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build","lint":"eslint src/**/*.ts --fix","lint:check":"eslint src/**/*.ts","format":"prettier --write src/**/*.ts","format:check":"prettier --check src/**/*.ts","typecheck":"tsc --noEmit","validate":"npm run typecheck && npm run lint:check && npm test","copy-templates":"copyfiles -f src/templates/* dist/templates/ && copyfiles -f src/templates/commands/* dist/templates/commands/"},"keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity","documentation","pattern-matching","complexity-analysis","token-optimization"],"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/byrem6/ai-dev-tools.git"},"bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","dependencies":{"@babel/parser":"^7.29.2","@babel/traverse":"^7.29.0","@babel/types":"^7.29.0","chalk":"^4.1.2","commander":"^11.1.0","fast-glob":"^3.3.2","glob":"^10.3.10","ignore":"^5.3.0","uuid":"^9.0.1"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^20.10.6","@types/uuid":"^9.0.7","@typescript-eslint/eslint-plugin":"^6.17.0","@typescript-eslint/parser":"^6.17.0","copyfiles":"^2.4.1","eslint":"^8.56.0","jest":"^29.7.0","prettier":"^3.1.1","ts-jest":"^29.4.6","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"gitHead":"d0c4bebb9377f172f5777be75bd5579c8be798a8","types":"./dist/index.d.ts","_id":"@byrem6/ai-dev-tools@2.0.1","_nodeVersion":"25.5.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-eVXvkYeeLO7/WhXcRLK069KuIsqA/5Vzuhg/nnmw3I2aLPDG619qlSCliaQFxIahiwgJZd0LyUGL03wNSkmDVw==","shasum":"87aa9949d2afe7a93d3c747df9fc76771720e691","tarball":"https://registry.npmjs.org/@byrem6/ai-dev-tools/-/ai-dev-tools-2.0.1.tgz","fileCount":469,"unpackedSize":1987164,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHfqAh+5SSvPReUPQ7pRx9MXZ79k/z72U8N++sKbnjJLAiBlAXTuJnFac4nG0Xz041On5fyl4T8c4aBkS0ZA+Y5m2w=="}]},"_npmUser":{"name":"byrem6","email":"remindfunction@gmail.com"},"directories":{},"maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ai-dev-tools_2.0.1_1774118193169_0.05417316001963446"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T16:51:52.292Z","modified":"2026-03-21T18:36:33.486Z","1.0.0":"2026-03-20T16:51:52.637Z","1.0.1":"2026-03-20T16:55:07.323Z","1.0.2":"2026-03-20T17:07:59.115Z","1.1.0":"2026-03-20T17:37:32.112Z","2.0.0":"2026-03-21T07:52:33.203Z","2.0.1":"2026-03-21T18:36:33.370Z"},"bugs":{"url":"https://github.com/byrem6/ai-dev-tools/issues"},"author":{"name":"Ramazan Hocaoglu"},"license":"MIT","homepage":"https://github.com/byrem6/ai-dev-tools/ai-dev-tools#readme","keywords":["cli","ai","developer-tools","ast","code-analysis","token-efficient","code-navigation","refactoring","git","search","developer-productivity","documentation","pattern-matching","complexity-analysis","token-optimization"],"repository":{"type":"git","url":"git+https://github.com/byrem6/ai-dev-tools.git"},"description":"AI Dev Tools (adt) - Token-efficient CLI for AI agents and developers with advanced doc analysis features","maintainers":[{"name":"byrem6","email":"remindfunction@gmail.com"}],"readme":"# 🤖 AI Dev Tools (adt)\n\n<div align=\"center\">\n\n**Token-efficient CLI for AI agents and developers**\n\n[![npm version](https://badge.fury.io/js/@byrem6%2Fai-dev-tools.svg)](https://www.npmjs.com/package/@byrem6/ai-dev-tools)\n[![Downloads](https://img.shields.io/npm/dm/@byrem6/ai-dev-tools.svg)](https://www.npmjs.com/package/@byrem6/ai-dev-tools)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/node/v/@byrem6/ai-dev-tools.svg)](https://nodejs.org)\n\n**5-7× less token usage than JSON • 94 commands • Cross-platform**\n\n[Features](#-features) • [Quick Start](#-quick-start) • [Commands](#-commands) • [Examples](#-usage-examples) • [API](#-api)\n\n</div>\n\n---\n\n## 📖 Overview\n\n**AI Dev Tools (adt)** is a revolutionary CLI tool designed specifically for AI agents and developers who want maximum efficiency. By using intelligent output formatting, adt achieves **5-7× token savings** compared to traditional JSON output while maintaining full human readability.\n\n### 🎯 Perfect For\n\n- **AI Agents** (Claude, GPT-4, Copilot, Cursor) - Minimize context window usage\n- **Developers** - Lightning-fast code navigation and analysis\n- **DevOps Engineers** - Automated project analysis and health checks\n- **Code Reviewers** - Intelligent change detection and impact analysis\n\n---\n\n## ✨ Key Features\n\n### 🚀 Token Efficiency\n- **65-80% token savings** with `slim` format\n- **3 output modes**: `slim`, `normal`, `json`\n- **Smart truncation** for large outputs\n- **Token estimation** in every response\n\n### 🧠 AI-Powered Intelligence\n- **Smart suggestions** based on codebase state\n- **Context tracking** for decision history\n- **Automated planning** for complex goals\n- **Change review** before commits\n\n### ⚡ Powerful Operations\n- **94 commands** across 27 categories\n- **Command chaining** with pipe operator\n- **Parallel batch execution**\n- **Cross-platform** (Windows, Linux, macOS)\n\n### 🛡️ Safety First\n- **Atomic operations** with automatic rollback\n- **Backup creation** before destructive actions\n- **Verification before** editing\n- **Git safety checks**\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Global installation (recommended)\nnpm install -g @byrem6/ai-dev-tools\n\n# Local development\nnpm install --save-dev @byrem6/ai-dev-tools\n\n# Using npx (no installation)\nnpx @byrem6/ai-dev-tools --help\n```\n\n### First Steps\n\n```bash\n# Check your environment\nadt doctor\n\n# Get intelligent suggestions for your project\nadt smart suggest\n\n# Explore your codebase\nadt map . --fmt normal\n\n# Initialize AI tool configs\nadt init\n```\n\n---\n\n## 📊 Token Efficiency Comparison\n\n| Command | JSON Output | Slim Format | Savings |\n|---------|-------------|-------------|---------|\n| `grep` (10 matches) | ~280 tokens | ~45 tokens | **84%** |\n| `git status` | ~85 tokens | ~22 tokens | **74%** |\n| `complexity` (20 files) | ~320 tokens | ~60 tokens | **81%** |\n| `read` (100 lines) | ~180 tokens | ~35 tokens | **81%** |\n| **Average** | - | - | **~75%** |\n\n---\n\n## 🎯 Usage Examples\n\n### For AI Agents\n\n```bash\n# Session initialization\nadt resume --fmt slim\nadt context get --fmt slim\n\n# Quick symbol location (slim format for minimum tokens)\nadt where \"UserService\" src/ --fmt slim\n# Output: src/services/UserService.ts:45:8\n\n# Read specific range\nadt read src/services/UserService.ts --start 45 --lines 20 --fmt normal\n\n# Safe editing workflow\nadt verify src/app.ts --lines 100:105 --contains \"export function\"\nadt patch src/app.ts --replace 100:105 --with \"export async function\" --dry-run\nadt patch src/app.ts --replace 100:105 --with \"export async function\"\n```\n\n### For Developers\n\n```bash\n# Quick file overview\nadt peek src/components/Header.ts\n\n# Find all usages\nadt refs \"useEffect\" src/\n\n# Analyze complexity\nadt complexity src/ --top 10\n\n# Check project health\nadt health --verbose\n\n# Generate changelog\nadt changelog --version 2.0.0\n```\n\n### AI-Powered Workflow\n\n```bash\n# 1. Get intelligent suggestions\nadt smart suggest\n\n# 2. Track your decisions\nadt context track \"Use TypeScript strict mode\" --reason \"Better type safety\"\n\n# 3. Create implementation plan\nadt smart plan \"refactor authentication system\"\n\n# 4. Execute with batch operations\nadt batch --file refactor-plan.txt --parallel\n\n# 5. Review changes before commit\nadt smart review\n\n# 6. View decision history\nadt context history --fmt normal\n```\n\n---\n\n## 📚 Commands\n\n### 🔍 Read & Navigation\n\n```bash\n# Smart file reading\nadt read <file> [options]\n  --start N         Start line number\n  --lines N         Number of lines to read\n  --around N        Read around line (context)\n  --fn <name>       Read function by name\n  --fmt slim|normal|json\n\n# Quick file overview\nadt peek <file> --fmt slim\n# Output: TypeScript  202 lines  11.7 KB  utf-8 CRLF\n\n# File structure\nadt outline <file> --fmt slim\n# Output: class UserService :45–200\n#         method constructor :50–55\n#         method login :57–80\n\n# Symbol listing\nadt symbols <file> --fmt slim\n```\n\n### 🔎 Search & Discovery\n\n```bash\n# Pattern search (grep-style)\nadt grep \"<pattern>\" [path] --fmt slim\n# Output: src/service.ts:45:8:async function login(\n\n# Find files by name/pattern\nadt find \"*.service.ts\" src/ --fmt slim\n\n# Locate symbols\nadt where \"UserService\" src/ --fmt slim\n\n# Find references\nadt refs \"AuthService\" src/ --fmt slim\n\n# Deep search with context\nadt search \"login\" src/ --fmt normal\n```\n\n### 🛠️ Editing & Refactoring\n\n```bash\n# Safe editing workflow\nadt verify <file> --lines N:M --contains \"<text>\"\nadt patch <file> --replace N:M --with \"<new>\" --dry-run\nadt patch <file> --replace N:M --with \"<new>\"\n\n# String replacement\nadt replace \"<old>\" \"<new>\" <file> --regex\n\n# File operations\nadt create <file> --type ts|js|jsx|tsx\nadt delete <file> --backup\nadt move <file> <new-path> --update-imports\nadt copy <source> <dest>\nadt rename <old-name> <new-name> --scope project\n```\n\n### 📊 Analysis & Metrics\n\n```bash\n# Project structure\nadt map [path] --fmt slim\nadt tree [path] --depth 2\nadt stats [path] --by-extension\n\n# Dependency analysis\nadt deps <file> --file\nadt impact <symbol> --scope <path>\n\n# Code complexity\nadt complexity [path] --top 20 --action hotspot|file|debt\n\n# Project health\nadt health --verbose\n# Output: score: 75/100\n#         Structure: ✓\n#         Documentation: ✗\n#         Testing: ⚠\n\n# Find duplicate code\nadt duplicate [path] --lines 5 --no-whitespace\n\n# Find unused code\nadt unused [path] --check imports|exports|both\n```\n\n### 🧠 AI Features (NEW!)\n\n```bash\n# Smart suggestions\nadt smart suggest\n# Analyzes codebase and suggests next actions\n\n# Deep analysis\nadt smart analyze\n# Complete codebase health and metrics\n\n# Goal planning\nadt smart plan \"<goal>\"\n# Generates step-by-step implementation plan\n\n# Change review\nadt smart review\n# Validates changes before commit\n```\n\n### 🔄 Context & Decisions (NEW!)\n\n```bash\n# Track decisions\nadt context track \"<decision>\" --reason \"<why>\"\n\n# View context\nadt context get --fmt normal\n\n# Decision history\nadt context history --fmt normal\n\n# Get AI suggestions\nadt context suggest\n\n# Search context\nadt context search --query \"<term>\"\n\n# Clear context\nadt context clear\n```\n\n### ⚡ Batch & Automation (NEW!)\n\n```bash\n# Batch file execution\nadt batch --file <batch-file> --parallel\n\n# Inline commands\nadt batch --commands \"grep 'export' src/ | symbols src/index.ts\"\n\n# Batch file format:\n# grep \"TODO\" src/\n# complexity src/\n# health\n```\n\n### 🐙 Git Operations\n\n```bash\n# Git status (slim format)\nadt git status --fmt slim\n\n# Git log\nadt git log --limit 20 --fmt slim\n\n# Git diff\nadt git diff --staged --fmt normal\n\n# Git commit\nadt git commit --message \"feat: add user auth\"\n\n# Branch management\nadt git branch list\nadt git branch create feature/auth\n\n# Stash, reset, merge, tag, cherry-pick...\n```\n\n### 🧪 Quality & Testing\n\n```bash\n# Linting\nadt lint [path] --fix\n\n# Testing\nadt test [file] --coverage\n\n# Type checking\nadt typecheck [path]\n\n# Code formatting\nadt format [path] --check\n```\n\n### 📝 Documentation\n\n```bash\n# Generate table of contents\nadt toc <file>\n\n# Split documentation\nadt split <file> --chapters\n\n# Generate docs\nadt doc generate --all\n```\n\n### 🌐 Additional Commands\n\n```bash\n# API Endpoints\nadt api-list [path]                    # List all API endpoints\nadt api-find \"<pattern>\" [path]        # Find endpoints by pattern\nadt api-routes [path]                  # Show routing details\n\n# Architecture Rules\nadt arch-rules list                    # List architecture rules\nadt arch-check [path]                  # Check rule compliance\nadt arch-rule-add <spec>               # Add new rule\n\n# Code Patterns\nadt pattern match \"<regex>\" [path]     # Match code patterns\nadt tag add \"<note>\" <file>            # Tag code locations\n\n# Security & Risk\nadt security [path] --severity high    # Security vulnerability scan\nadt risk [path] --threshold high       # Risk analysis\nadt contract-check <class> [path]      # Interface contract check\n\n# Testing & Coverage\nadt coverage-report [path]             # Test coverage report\n\n# Code Generation\nadt generate-service <name>            # Generate service class\nadt generate-model <name>              # Generate model/interface\nadt generate-test <name>               # Generate test file\n\n# Integrations & Migration\nadt integration-list [path]            # List external APIs\nadt migrate-scan <package> [path]      # Scan deprecated APIs\n\n# Data Flow & History\nadt flow-trace <symbol> [path]         # Trace data flow\nadt history-file <file>                # File git history\n\n# Workspace & Configuration\nadt workspace-list [path]              # List monorepo packages\nadt config-flags [path]                # List feature flags\n\n# Documentation\nadt doc coverage <file>                # Check docs coverage\nadt split <file> --lines 400           # Split large docs\nadt toc <file>                         # Generate TOC\n\n# Task & Session Management\nadt task create \"<title>\"              # Create task\nadt session show                       # Show session state\nadt resume                             # Resume last session\n```\n\n---\n\n## 🔧 Command Categories\n\n| Category | Commands | Description |\n|----------|----------|-------------|\n| **READ** | read, peek, outline | Smart file reading |\n| **SEARCH** | grep, find, where, search, refs | Pattern search & discovery |\n| **SYMBOL** | symbols, sig, def, body, callers, callees | Symbol navigation |\n| **EDIT** | verify, patch, replace, create, delete, move, copy, rename | Safe editing operations |\n| **MAP** | map, tree, stats, deps, impact | Project structure & analysis |\n| **GIT** | git-status, git-log, git-diff, git-blame, git-branch, git-commit, git-stash, git-reset, git-merge, git-tag, git-cherry-pick | Git operations |\n| **SHELL** | exec, platform, run, env, which | Shell & system commands |\n| **QUALITY** | lint, test, typecheck, format | Code quality checks |\n| **AI** | ai, smart, quick, batch | AI-powered features |\n| **CONTEXT** | context | Decision tracking |\n| **UTILITY** | info, files, recent, duplicate, unused, health, changelog, safe | Developer utilities |\n| **DOCUMENTATION** | doc, split, toc | Documentation tools |\n| **ARCHITECTURE** | arch-rules, arch-check, arch-rule-add | Architecture rules |\n| **PATTERN** | pattern, tag | Code patterns |\n| **SECURITY** | security, risk | Security analysis |\n| **TESTING** | coverage-report | Test coverage |\n| **GENERATION** | generate-service, generate-model, generate-test | Code generation |\n| **API** | api-list, api-find, api-routes | API endpoints |\n| **INTEGRATION** | integration-list | External integrations |\n| **MIGRATION** | migrate-scan | Migration tools |\n| **FLOW** | flow-trace | Data flow |\n| **CONTRACT** | contract-check | Interface contracts |\n| **CONFIGURATION** | config-flags | Configuration |\n| **WORKSPACE** | workspace-list | Monorepo workspace |\n| **HISTORY** | history-file | File history |\n| **SESSION** | session, resume | Session management |\n| **TASK** | task | Task management |\n| **SYSTEM** | init, doctor | System setup & diagnostics |\n\n---\n\n## 💡 Pro Tips\n\n### Format Selection Guide\n\n| Situation | Best Format | Why |\n|-----------|-------------|-----|\n| AI agent queries | `slim` | Minimum tokens (5-7× savings) |\n| Grep/search results | `slim` | Classic format, parseable |\n| Human reading | `normal` | Balanced, readable |\n| Code review | `normal` | Rich context, structured |\n| Nested analysis | `json` | Required for complex data |\n| Programmatic use | `json` | Easy to parse |\n\n### AI Agent Best Practices\n\n```bash\n# 1. Always use slim for location queries\nadt where \"symbol\" src/ --fmt slim\n\n# 2. Use normal for content you'll analyze\nadt read file.ts --start 100 --lines 50 --fmt normal\n\n# 3. Batch operations for efficiency\nadt batch --file commands.txt --parallel\n\n# 4. Track context for better suggestions\nadt context track \"Working on auth feature\"\n\n# 5. Use smart suggestions when stuck\nadt smart suggest\n```\n\n### Token Optimization\n\n```bash\n# ❌ Inefficient ( wastes tokens)\nadt read large-file.ts --fmt json\n# Output: ~2000 tokens\n\n# ✅ Efficient (saves 80% tokens)\nadt read large-file.ts --start 100 --lines 50 --fmt slim\n# Output: ~400 tokens\n```\n\n---\n\n## 📦 API & Integration\n\n### Programmatic Usage\n\n```javascript\nconst { ExecCommand } = require('@byrem6/ai-dev-tools');\n\n// Use adt in your Node.js scripts\nconst exec = new ExecCommand();\nconst result = await exec.execute('npm', 'test', '--fmt', 'slim');\nconsole.log(result.content);\n```\n\n### VS Code Integration\n\n```json\n// settings.json\n{\n  \"terminal.integrated.defaultProfile.windows\": \"PowerShell\",\n  \"terminal.integrated.profiles.windows\": {\n    \"adt\": {\n      \"path\": \"adt\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### GitHub Actions\n\n```yaml\n- name: Code Analysis\n  run: |\n    npm install -g @byrem6/ai-dev-tools\n    adt health --exit-on-error\n    adt complexity src/ --fail-above 15\n```\n\n---\n\n## 🎨 Output Formats\n\n### Slim Format (Token-Optimized)\n\n```\nok true\nsrc/services/UserService.ts:45:8:async function login(\nsrc/controllers/AuthController.ts:78:12:login(\ntests/UserService.test.ts:23:5:login(\n---\ncount: 3  ~tokens: 45\n```\n\n### Normal Format (Human-Readable)\n\n```\nok: true\ncommand: grep\npattern: login\n===\n\nsrc/services/UserService.ts:45:8\n  async function login(\n    username: string,\n    password: string\n  ): Promise<User>\n\nsrc/controllers/AuthController.ts:78:12\n  login(\n    req: Request,\n    res: Response\n  )\n\n---\nmatches: 2  files: 2  ~tokens: 120\n```\n\n### JSON Format (Programmatic)\n\n```json\n{\n  \"ok\": true,\n  \"command\": \"grep\",\n  \"pattern\": \"login\",\n  \"matches\": [\n    {\n      \"file\": \"src/services/UserService.ts\",\n      \"line\": 45,\n      \"col\": 8,\n      \"text\": \"async function login(\"\n    }\n  ],\n  \"metadata\": {\n    \"count\": 2,\n    \"files\": 2\n  }\n}\n```\n\n---\n\n## 🛠️ Configuration\n\n### Config File Location\n\n```bash\n~/.adt/config.json\n```\n\n### Default Config\n\n```json\n{\n  \"defaultFmt\": \"normal\",\n  \"defaultLines\": 100,\n  \"maxCatLines\": 500,\n  \"maxGrepResults\": 100,\n  \"backupRetentionDays\": 7,\n  \"excludeByDefault\": [\n    \"node_modules/**\",\n    \"dist/**\",\n    \".git/**\",\n    \"coverage/**\"\n  ],\n  \"tokenWarningThreshold\": 1000,\n  \"autoBackup\": true,\n  \"defaultShell\": \"auto\",\n  \"gitSafetyChecks\": true,\n  \"patchVerifyBeforeApply\": true\n}\n```\n\n---\n\n## 🤝 AI Tool Integration\n\n### Supported Tools\n\n```bash\n# Auto-generate configs for all tools\nadt init\n\n# Specific tools\nadt init --tools claude\nadt init --tools cursor\nadt init --tools copilot\nadt init --tools claude,cursor\n```\n\nGenerated configs:\n- `.claude/instructions.md`\n- `.cursorrules`\n- `.github/copilot-instructions.md`\n- `.opencode/config.json`\n\n---\n\n## 📈 Performance\n\n### Benchmarks\n\n| Operation | Time | Tokens |\n|-----------|------|--------|\n| Grep (1000 files) | ~2s | ~50 (slim) |\n| Complexity (100 files) | ~3s | ~60 (slim) |\n| Map (large project) | ~1s | ~30 (slim) |\n| Batch (10 commands) | ~0.5s | ~40 (slim) |\n\n### System Requirements\n\n- **Node.js**: >= 18.0.0\n- **OS**: Windows, Linux, macOS\n- **Memory**: 512MB minimum\n- **Disk**: 50MB installed\n\n---\n\n## 🆚 Comparison\n\n| Feature | adt | rg + jq | ag | grep |\n|---------|-----|---------|-----|------|\n| Token-efficient output | ✅ | ❌ | ❌ | ❌ |\n| Multi-format output | ✅ | ❌ | ❌ | ❌ |\n| Symbol navigation | ✅ | ❌ | ❌ | ❌ |\n| Dependency analysis | ✅ | ❌ | ❌ | ❌ |\n| Safe editing | ✅ | ❌ | ❌ | ❌ |\n| Git integration | ✅ | ❌ | ❌ | ❌ |\n| AI-powered features | ✅ | ❌ | ❌ | ❌ |\n| Cross-platform | ✅ | ✅ | ✅ | ✅ |\n\n---\n\n## 📚 Documentation\n\n- **Full Command Reference**: See `src/templates/commands/COMMANDS.md` (94 commands documented)\n- **Quick Start Guide**: See `src/templates/commands/QUICKSTART.md`\n- **Examples**: See `src/templates/commands/EXAMPLES.md`\n- **Full Design Spec**: [README_DESIGN.md](./README_DESIGN.md)\n- **v2.0 Implementation**: [ADT_V2_FINAL_REPORT.md](./ADT_V2_FINAL_REPORT.md)\n- **Improvements Log**: [ADT_IMPROVEMENTS.md](./ADT_IMPROVEMENTS.md)\n- **v2.0 Plan**: [ADT_V2_PLAN.md](./ADT_V2_PLAN.md)\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our contributing guidelines and submit pull requests.\n\n```bash\n# Development\ngit clone https://github.com/byrem6/ai-dev-tools.git\ncd ai-dev-tools\nnpm install\nnpm run build\nnpm run validate\n```\n\n---\n\n## 📝 Changelog\n\n### v2.0.0 (Latest)\n- ✨ 94 commands across 27 categories\n- ✨ All commands now documented in templates\n- ✨ Enhanced descriptions for all commands\n- ✨ API, Architecture, Security, and more categories\n- ✨ Complete command reference in templates\n- ⚡ 5-7× token efficiency improvements\n- 📚 Comprehensive documentation\n\n### v1.1.0\n- Initial stable release\n- 60+ commands across 12 categories\n- Token-efficient output system\n\n---\n\n## 📄 License\n\nMIT © 2025 Ramazan Hocaoglu\n\n[GitHub](https://github.com/byrem6/ai-dev-tools) •\n[NPM](https://www.npmjs.com/package/@byrem6/ai-dev-tools) •\n[Issues](https://github.com/byrem6/ai-dev-tools/issues)\n\n---\n\n<div align=\"center\">\n\n**Built with ❤️ for AI agents and developers**\n\n⭐ Star us on GitHub — it helps!\n\n</div>\n","readmeFilename":"README.md"}