claude-config-cli 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 KazooTTT
+
+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,177 @@
+# Claude Config CLI
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+
+A CLI tool to manage Claude Code configuration files by scanning existing configs and applying recommended settings.
+
+## Features
+
+- **Scan Mode**: Scan multiple directories to find existing Claude config files and generate a recommended configuration
+- **Apply Mode**: Directly apply a pre-defined recommended configuration
+- **Merge or Overwrite**: Choose to merge with existing configs or overwrite them
+- **Interactive CLI**: User-friendly prompts for all operations
+
+## Installation
+
+```bash
+# Using npm
+npm install -g claude-config-cli
+
+# Using pnpm
+pnpm add -g claude-config-cli
+
+# Using yarn
+yarn global add claude-config-cli
+```
+
+Or use directly with npx (no installation needed):
+
+```bash
+npx claude-config-cli
+```
+
+## Usage
+
+### Command: `scan`
+
+Scan directories for Claude config files and generate recommended configuration.
+
+```bash
+# Scan current directory
+claude-config scan
+
+# Scan specific directories
+claude-config scan ~/personal ~/work
+
+# Preview without applying
+claude-config scan --preview
+
+# Specify output path
+claude-config scan -o .claude/settings.local.json
+```
+
+### Command: `apply`
+
+Apply the recommended Claude configuration directly.
+
+```bash
+# Apply with interactive prompts
+claude-config apply
+
+# Preview the recommended config
+claude-config apply --preview
+
+# Specify output path
+claude-config apply -o /custom/path/settings.json
+```
+
+### Options
+
+Both commands support the following options:
+
+- `-o, --output <path>`: Specify the output file path (default: `.claude/settings.local.json`)
+- `-p, --preview`: Preview the configuration without applying it
+- `-h, --help`: Display help information
+
+### Interactive Prompts
+
+When you run `scan` or `apply` without `--preview`, you'll be prompted to choose an action:
+
+- **Save to new file**: Create a new config file
+- **Merge with existing config**: Merge the recommended config with any existing config (preserves existing settings)
+- **Overwrite existing config**: Replace any existing config with the recommended one
+- **Cancel**: Cancel the operation
+
+## Example Workflow
+
+### 1. Scan and Preview
+
+```bash
+npx claude-config scan ~/personal ~/work --preview
+```
+
+This will show you the recommended configuration based on all configs found in the specified directories.
+
+### 2. Apply Recommended Config
+
+```bash
+npx claude-config apply
+```
+
+You'll be prompted to choose how to apply the config. Select your preferred option and the tool will handle the rest.
+
+### 3. Scan and Apply in One Step
+
+```bash
+npx claude-config scan ~/projects
+```
+
+After scanning, choose how you want to apply the generated configuration.
+
+## Recommended Configuration
+
+The recommended configuration includes common permissions for:
+
+- Package managers (pnpm, npm, bun)
+- Build tools (cargo, wrangler)
+- Git operations
+- Development tools (node, python, tsc)
+- MCP tools (context7, ast-grep, ide)
+
+This configuration is based on common patterns found across many projects.
+
+## Development
+
+### Local Testing
+
+```bash
+# Install dependencies
+pnpm install
+
+# Test the CLI
+node cli.js --help
+node cli.js scan --preview
+node cli.js apply --preview
+
+# Run tests
+pnpm test
+```
+
+### Publishing to npm
+
+```bash
+# Build (if you have a build step)
+pnpm run build
+
+# Publish
+pnpm publish
+```
+
+## Release
+
+This project uses [bumpp](https://github.com/antfu/bumpp) for version management.
+
+```bash
+# Interactive release
+pnpm release
+
+# Automatic release (patch/minor/major)
+pnpm release:patch
+pnpm release:minor
+pnpm release:major
+```
+
+## License
+
+[MIT](./LICENSE) License
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/claude-config-cli?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/claude-config-cli
+[npm-downloads-src]: https://img.shields.io/npm/dm/claude-config-cli?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/claude-config-cli
+[license-src]: https://img.shields.io/github/license/kazoottt/claude-config-generate.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/kazoottt/claude-config-generate/blob/main/LICENSE

package/cli.js

@@ -0,0 +1,378 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 预定义的推荐配置
+const RECOMMENDED_CONFIG = {
+  permissions: {
+    allow: [
+      "Bash(pnpm build:*)",
+      "WebSearch",
+      "Bash(find:*)",
+      "Bash(npm run build:*)",
+      "Bash(pnpm add:*)",
+      "Bash(pnpm typecheck:*)",
+      "Bash(pnpm lint:*)",
+      "Bash(cargo check:*)",
+      "Bash(wrangler d1 execute:*)",
+      "Bash(git diff:*)",
+      "Bash(xargs:*)",
+      "Bash(python:*)",
+      "Bash(mv:*)",
+      "Bash(npm run lint)",
+      "Bash(node:*)",
+      "Bash(git branch:*)",
+      "mcp__context7__resolvelibraryid",
+      "mcp__ide__getDiagnostics",
+      "Bash(npm run dev:*)",
+      "Bash(bunx:*)",
+      "Bash(pnpm run:*)",
+      "Bash(npx tsc:*)",
+      "mcp__astgrep__find_code",
+      "Bash(python3:*)",
+      "Bash(chmod:*)"
+    ],
+    deny: [],
+    ask: []
+  }
+};
+
+const program = new Command();
+
+program
+  .name('claude-config')
+  .description('CLI tool to manage Claude Code configuration files')
+  .version('1.0.0');
+
+// 扫描命令
+program
+  .command('scan')
+  .description('Scan directories for Claude config files and generate recommended config')
+  .argument('[dirs...]', 'Directories to scan (default: current directory)')
+  .option('-o, --output <path>', 'Output file path (default: .claude/settings.local.json)')
+  .option('-p, --preview', 'Preview the recommended config without applying')
+  .action(async (dirs, options) => {
+    const scanDirs = dirs.length > 0 ? dirs : [process.cwd()];
+    const outputPath = options.output || path.join(process.cwd(), '.claude/settings.local.json');
+
+    console.log(chalk.blue('🔍 Scanning directories for Claude config files...'));
+    scanDirs.forEach(dir => console.log(chalk.gray(`   ${dir}`)));
+
+    const configFiles = findConfigFiles(scanDirs);
+    console.log(chalk.blue(`\n📊 Found ${configFiles.length} config file(s)\n`));
+
+    if (configFiles.length === 0) {
+      console.log(chalk.yellow('⚠️  No config files found. Use the "apply" command to use the recommended config.'));
+      return;
+    }
+
+    const stats = scanConfigs(configFiles);
+    const recommended = generateRecommendedConfig(stats);
+
+    if (options.preview) {
+      console.log(chalk.green('📋 Recommended Configuration:\n'));
+      console.log(JSON.stringify(recommended, null, 2));
+      return;
+    }
+
+    // Ask user what to do
+    const { action } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'action',
+        message: 'What would you like to do?',
+        choices: [
+          { name: '💾 Save to new file', value: 'save' },
+          { name: '🔀 Merge with existing config (if exists)', value: 'merge' },
+          { name: '♻️  Overwrite existing config (if exists)', value: 'overwrite' },
+          { name: '❌ Cancel', value: 'cancel' }
+        ]
+      }
+    ]);
+
+    if (action === 'cancel') {
+      console.log(chalk.gray('Operation cancelled.'));
+      return;
+    }
+
+    await applyConfig(recommended, outputPath, action);
+  });
+
+// 应用命令
+program
+  .command('apply')
+  .description('Apply the recommended Claude config')
+  .option('-o, --output <path>', 'Output file path (default: .claude/settings.local.json)')
+  .option('-p, --preview', 'Preview the recommended config without applying')
+  .action(async (options) => {
+    const outputPath = options.output || path.join(process.cwd(), '.claude/settings.local.json');
+
+    if (options.preview) {
+      console.log(chalk.green('📋 Recommended Configuration:\n'));
+      console.log(JSON.stringify(RECOMMENDED_CONFIG, null, 2));
+      return;
+    }
+
+    console.log(chalk.green('🚀 Applying recommended Claude configuration...\n'));
+
+    const { action } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'action',
+        message: 'How would you like to apply the config?',
+        choices: [
+          { name: '💾 Save to new file', value: 'save' },
+          { name: '🔀 Merge with existing config (if exists)', value: 'merge' },
+          { name: '♻️  Overwrite existing config (if exists)', value: 'overwrite' },
+          { name: '❌ Cancel', value: 'cancel' }
+        ]
+      }
+    ]);
+
+    if (action === 'cancel') {
+      console.log(chalk.gray('Operation cancelled.'));
+      return;
+    }
+
+    await applyConfig(RECOMMENDED_CONFIG, outputPath, action);
+  });
+
+/**
+ * 查找配置文件
+ */
+function findConfigFiles(dirs) {
+  const CONFIG_PATHS = [
+    '.claude/settings.local.json',
+    '@.claude/settings.local.json',
+    '.claude.json',
+  ];
+
+  const files = [];
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) continue;
+
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+
+        // 跳过隐藏目录（除了 .claude）
+        if (entry.name.startsWith('.') && entry.name !== '.claude') {
+          continue;
+        }
+
+        // 跳过 node_modules
+        if (entry.name === 'node_modules' || entry.name === '.git') {
+          continue;
+        }
+
+        // 检查是否是配置文件
+        for (const configPath of CONFIG_PATHS) {
+          const configFile = path.join(fullPath, configPath);
+          if (fs.existsSync(configFile)) {
+            files.push(configFile);
+          }
+        }
+
+        // 递归查找子目录
+        if (entry.isDirectory()) {
+          files.push(...findConfigFiles([fullPath]));
+        }
+      }
+    } catch (err) {
+      // 忽略权限错误
+    }
+  }
+
+  return files;
+}
+
+/**
+ * 扫描配置文件并统计
+ */
+function scanConfigs(configFiles) {
+  const stats = {
+    permissions: { allow: new Map(), deny: new Map(), ask: new Map() },
+    allowToRun: new Map(),
+    allowedCommands: new Map(),
+    allowedFileOperations: new Map(),
+    excludedPaths: new Map(),
+  };
+
+  for (const filePath of configFiles) {
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      const config = JSON.parse(content);
+
+      // 统计 permissions
+      if (config.permissions) {
+        ['allow', 'deny', 'ask'].forEach(type => {
+          if (Array.isArray(config.permissions[type])) {
+            config.permissions[type].forEach(item => {
+              const count = stats.permissions[type].get(item) || 0;
+              stats.permissions[type].set(item, count + 1);
+            });
+          }
+        });
+      }
+
+      // 统计其他配置项
+      [
+        'allowToRun',
+        'allowedCommands',
+        'allowedFileOperations',
+        'excludedPaths'
+      ].forEach(key => {
+        if (Array.isArray(config[key])) {
+          config[key].forEach(item => {
+            const count = stats[key].get(item) || 0;
+            stats[key].set(item, count + 1);
+          });
+        }
+      });
+
+    } catch (err) {
+      console.error(chalk.red(`❌ Failed to parse ${filePath}`));
+    }
+  }
+
+  return stats;
+}
+
+/**
+ * 生成推荐配置（过滤特定路径）
+ */
+function generateRecommendedConfig(stats) {
+  const isGlobal = (item) => {
+    if (typeof item !== 'string') return true;
+    return !item.includes('/Users/') && !item.includes('/home/');
+  };
+
+  const recommended = {};
+
+  // 收集 permissions.allow
+  const allAllow = Array.from(stats.permissions.allow.entries())
+    .filter(([item]) => isGlobal(item))
+    .filter(([_, count]) => count >= 2)
+    .sort((a, b) => b[1] - a[1])
+    .map(([item]) => item);
+
+  if (allAllow.length > 0) {
+    recommended.permissions = {
+      allow: allAllow,
+      deny: [],
+      ask: []
+    };
+  }
+
+  // 收集其他配置项
+  [
+    'allowToRun',
+    'allowedCommands',
+    'allowedFileOperations',
+    'excludedPaths'
+  ].forEach(key => {
+    const items = Array.from(stats[key].entries())
+      .filter(([item]) => isGlobal(item))
+      .filter(([_, count]) => count >= 2)
+      .sort((a, b) => b[1] - a[1])
+      .map(([item]) => item);
+
+    if (items.length > 0) {
+      recommended[key] = items;
+    }
+  });
+
+  return recommended;
+}
+
+/**
+ * 应用配置
+ */
+async function applyConfig(newConfig, outputPath, action) {
+  const dir = path.dirname(outputPath);
+
+  // 创建目录
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  let finalConfig = newConfig;
+
+  // 处理合并模式
+  if (action === 'merge' && fs.existsSync(outputPath)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(outputPath, 'utf8'));
+      finalConfig = mergeConfigs(existing, newConfig);
+      console.log(chalk.blue('🔀 Merging with existing configuration...'));
+    } catch (err) {
+      console.error(chalk.red('❌ Failed to parse existing config, using new config only'));
+    }
+  }
+
+  // 写入文件
+  fs.writeFileSync(outputPath, JSON.stringify(finalConfig, null, 2), 'utf8');
+
+  console.log(chalk.green(`✅ Configuration ${action === 'merge' ? 'merged' : 'applied'} successfully!`));
+  console.log(chalk.gray(`   Location: ${outputPath}\n`));
+
+  // 显示预览
+  console.log(chalk.blue('📋 Applied Configuration:\n'));
+  console.log(JSON.stringify(finalConfig, null, 2));
+}
+
+/**
+ * 合并配置（去重）
+ */
+function mergeConfigs(existing, newConfig) {
+  const merged = { ...existing };
+
+  // 合并 permissions
+  if (newConfig.permissions) {
+    if (!merged.permissions) {
+      merged.permissions = {};
+    }
+
+    ['allow', 'deny', 'ask'].forEach(type => {
+      if (newConfig.permissions[type]) {
+        const existingItems = merged.permissions[type] || [];
+        const newItems = newConfig.permissions[type];
+
+        // 合并并去重
+        const combined = [...new Set([...existingItems, ...newItems])];
+        merged.permissions[type] = combined;
+      }
+    });
+  }
+
+  // 合并数组配置项
+  [
+    'allowToRun',
+    'allowedCommands',
+    'allowedFileOperations',
+    'excludedPaths'
+  ].forEach(key => {
+    if (newConfig[key]) {
+      const existingItems = merged[key] || [];
+      const newItems = newConfig[key];
+
+      // 合并并去重
+      const combined = [...new Set([...existingItems, ...newItems])];
+      merged[key] = combined;
+    }
+  });
+
+  return merged;
+}
+
+program.parse();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "claude-config-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "packageManager": "pnpm@10.20.0",
+  "description": "CLI tool to manage Claude Code configuration files",
+  "author": "KazooTTT <work@kazoottt.top>",
+  "license": "MIT",
+  "homepage": "https://github.com/KazooTTT/claude-config-generate#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KazooTTT/claude-config-generate.git"
+  },
+  "bugs": "https://github.com/KazooTTT/claude-config-generate/issues",
+  "keywords": [
+    "claude",
+    "config",
+    "cli",
+    "claude-code",
+    "configuration"
+  ],
+  "bin": {
+    "claude-config": "./cli.js"
+  },
+  "files": [
+    "cli.js"
+  ],
+  "scripts": {
+    "test": "node cli.js --help",
+    "release": "bumpp",
+    "release:next": "bumpp next --yes",
+    "release:patch": "bumpp patch --yes",
+    "release:minor": "bumpp minor --yes",
+    "release:major": "bumpp major --yes",
+    "prepack": "npm run test"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "inquirer": "^9.2.0"
+  },
+  "devDependencies": {
+    "bumpp": "^10.3.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}