claude-agents-md 1.8.0

package/.cursorindexingignore

@@ -0,0 +1,3 @@
+
+# Don't index SpecStory auto-save files, but allow explicit context inclusion via @ references
+.specstory/**

package/README.md

@@ -0,0 +1,128 @@
+# Claude AGENTS
+
+A wrapper for the Claude CLI that can run in AGENTS mode (ignoring CLAUDE.md and using AGENTS.md) OR CLAUDE mode (standard Claude behavior).
+
+## What's New 🎉
+
+- Switch between CLAUDE and AGENTS modes
+- Use the handy `cl` bash wrapper for quick mode switching
+- Mode preference is saved between sessions
+- **NEW**: Auto-start Claude after mode switch
+
+## Installation
+
+```bash
+# Install
+npm install -g claude-agents-md
+```
+
+The first time you run `claude-agents-md`, you will be presented with a consent prompt explaining the security implications. You must explicitly agree to continue.
+
+Your consent choice is remembered for future runs.
+
+### Using command-line flags
+
+```bash
+# Run in CLAUDE mode (normal Claude CLI behavior)
+claude-agents-md --claude
+claude-agents-md --no-agents
+
+# Run in AGENTS mode (default)
+claude-agents-md
+```
+
+### Using mode commands
+
+```bash
+# Switch to AGENTS mode
+claude-agents-md mode agents
+
+# Switch to CLAUDE mode
+claude-agents-md mode claude
+
+# Check current mode
+claude-agents-md mode
+```
+
+### Using the cl wrapper script (Recommended!)
+
+For even easier mode management, use the included `cl` bash wrapper:
+
+```bash
+# Install globally during npm install
+npm install -g claude-agents-md
+
+# Or copy manually to your PATH
+cp node_modules/claude-agents-md/bin/cl /usr/local/bin/cl
+chmod +x /usr/local/bin/cl
+
+# Now you can use:
+cl /YON      # Switch to AGENTS mode AND start Claude
+cl /YOFF     # Switch to CLAUDE mode AND start Claude
+cl /STATUS   # Show current mode (without starting Claude)
+cl /HELP     # Show help
+
+# Run Claude in current mode
+cl "write a hello world function"
+
+# Switch mode and run with command
+cl /YON "create a web server"
+```
+
+Mode preference is saved in `~/.claude_agents_state` and persists between sessions.
+
+## Visual Mode Indicators
+
+The tool now shows clear visual indicators of which mode you're in:
+
+- **AGENTS Mode**: `[AGENTS]` prefix in yellow 🔥
+- **CLAUDE Mode**: `[CLAUDE]` prefix in cyan 🛡️
+
+## Usage
+
+```bash
+claude-agents-md [options]
+```
+
+All arguments and options are passed directly to the Claude CLI.
+
+This wrapper in AGENTS mode:
+1. Checks for and automatically installs updates to the Claude package
+2. Displays "🔥 AGENTS MODE ACTIVATED 🔥" warning in yellow text
+3. Creates a modified copy of the Claude CLI code to use AGENTS.md
+4. Leaves the original Claude CLI file untouched (won't affect your normal `claude` command)
+
+In CLAUDE mode, it simply runs the original Claude CLI without modifications.
+
+## Why?
+
+You want to use AGENTS.md
+
+## Debugging
+
+If you encounter any issues, you can run with debug output:
+
+```bash
+DEBUG=1 claude-agents-md
+```
+
+This will show additional information about:
+- Claude package update checks
+- Current and latest available versions
+- When updates are being installed
+- Modifications being made to the CLI file
+
+## Auto-Update Feature
+
+Claude AGENTS automatically checks for updates to the Claude package each time it runs:
+
+1. When you run `claude-agents-md`, it checks for the latest version of `@anthropic-ai/claude-code` on npm
+2. If your installed version is outdated, it will:
+   - Update your package.json with the latest version
+   - Run npm install to get the newest version
+   - Notify you that an update was applied
+3. This ensures you're always using the latest Claude CLI features
+
+## Important Security Disclaimer
+
+This is an unofficial tool and not supported by Anthropic. Use at your own risk.

package/bin/cl

@@ -0,0 +1,116 @@
+#!/bin/bash
+
+# Claude AGENTS/CLAUDE.md Mode Wrapper Script
+# Usage: cl /YON | /YOFF | /STATUS | /HELP | [claude commands]
+
+# Barvy pro výstup
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+RESET='\033[0m'
+BOLD='\033[1m'
+
+# Soubor pro uložení stavu
+STATE_FILE="$HOME/.claude_agents_state"
+
+# Funkce pro čtení aktuálního režimu
+get_mode() {
+    if [ -f "$STATE_FILE" ]; then
+        cat "$STATE_FILE"
+    else
+        echo "CLAUDE"  # Výchozí je bezpečný režim
+    fi
+}
+
+# Funkce pro nastavení režimu
+set_mode() {
+    echo "$1" > "$STATE_FILE"
+}
+
+# Zpracování argumentů
+case "$1" in
+    /YON)
+        echo -e "${YELLOW}${BOLD}🔥 ACTIVATING AGENTS MODE 🔥${RESET}"
+        echo -e "${RED}⚠️  WARNING: All CLAUDE.md will be ignored!${RESET}"
+        echo -e "${RED}⚠️  Claude will use AGENTS.md instead${RESET}"
+        set_mode "AGENTS"
+        echo -e "${YELLOW}✓ AGENTS mode is now ON${RESET}"
+        ;;
+        
+    /YOFF)
+        echo -e "${CYAN}${BOLD}🛡️  ACTIVATING CLAUDE MODE 🛡️${RESET}"
+        echo -e "${GREEN}✓ CLAUDE.md will be enabled${RESET}"
+        set_mode "CLAUDE"
+        echo -e "${CYAN}✓ AGENTS mode is now OFF (CLAUDE.md mode ON)${RESET}"
+        ;;
+        
+    /STATUS)
+        MODE=$(get_mode)
+        echo -e "${BOLD}Claude CLI Status:${RESET}"
+        echo -e "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        if [ "$MODE" = "AGENTS" ]; then
+            echo -e "Mode: ${YELLOW}${BOLD}AGENTS${RESET} 🔥"
+            echo -e "Instructions: ${RED}CLAUDE.md will be ignored${RESET}"
+            echo -e "Instructions: ${GREEN}AGENTS.md will be used${RESET}"
+        else
+            echo -e "Mode: ${CYAN}${BOLD}CLAUDE${RESET} 🛡️"
+            echo -e "Instructions: ${GREEN}CLAUDE.md will be used${RESET}"
+            echo -e "Instructions: ${RED}AGENTS.md will be ignored${RESET}"
+        fi
+        echo -e "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        ;;
+        
+    /HELP|/H|/?)
+        echo -e "${BOLD}Claude CLI Wrapper - Help${RESET}"
+        echo -e "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${CYAN}cl /YON${RESET}     - Enable AGENTS mode (ignore CLAUDE.md)"
+        echo -e "${CYAN}cl /YOFF${RESET}    - Disable AGENTS mode (use CLAUDE.md)"
+        echo -e "${CYAN}cl /STATUS${RESET}  - Show current mode"
+        echo -e "${CYAN}cl /HELP${RESET}    - Show this help"
+        echo -e "${CYAN}cl [args]${RESET}   - Run claude with current mode"
+        echo -e "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e ""
+        echo -e "${BOLD}Examples:${RESET}"
+        echo -e "  cl /YON                    # Enable AGENTS mode"
+        echo -e "  cl /YOFF                   # Enable CLAUDE.md mode"
+        echo -e "  cl \"write a function\"      # Run Claude in current mode"
+        echo -e ""
+        echo -e "${BOLD}Mode Persistence:${RESET}"
+        echo -e "Your mode choice is saved in ~/.claude_agennts_state"
+        echo -e "and persists between terminal sessions."
+        ;;
+        
+    *)
+        # Spustit Claude v aktuálním režimu
+        MODE=$(get_mode)
+        
+        # Zobrazit režim před spuštěním
+        if [ "$MODE" = "AGENTS" ]; then
+            echo -e "${YELLOW}[AGENTS]${RESET} Running Claude in AGENTS.md mode..."
+            # Check if claude-agents-md is installed
+            if command -v claude-agents-md &> /dev/null; then
+                claude-agents-md "$@"
+            else
+                echo -e "${RED}Error: claude-agents-md is not installed${RESET}"
+                echo -e "Install it with: ${CYAN}npm install -g claude-agents-md${RESET}"
+                exit 1
+            fi
+        else
+            echo -e "${CYAN}[CLAUDE]${RESET} Running Claude in CLAUDE.md mode..."
+            # Check if claude is installed
+            if command -v claude &> /dev/null; then
+                claude "$@"
+            else
+                # If regular claude is not installed, use claude-agents-md with --claude flag
+                if command -v claude-agents-md &> /dev/null; then
+                    claude-agents-md --claude "$@"
+                else
+                    echo -e "${RED}Error: Neither claude nor claude-agents-md is installed${RESET}"
+                    echo -e "Install claude-agents-md with: ${CYAN}npm install -g claude-agents-md${RESET}"
+                    exit 1
+                fi
+            fi
+        fi
+        ;;
+esac

package/bin/claude-agents.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import readline from 'readline';
+
+// ANSI color codes
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+
+// Path to persistent state file
+const stateFile = path.join(os.homedir(), '.claude_agents_state');
+
+// Function to get current mode from state file
+function getMode() {
+  try {
+    return fs.readFileSync(stateFile, 'utf8').trim();
+  } catch {
+    return 'AGENTS'; // Default mode
+  }
+}
+
+// Function to set mode in state file
+function setMode(mode) {
+  fs.writeFileSync(stateFile, mode);
+}
+
+// Debug logging function that only logs if DEBUG env var is set
+const debug = (message) => {
+  if (process.env.DEBUG) {
+    console.log(message);
+  }
+};
+
+// Function to ask for user consent
+function askForConsent() {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    console.log(`\n${BOLD}${YELLOW}🔥 claude-agents-md CONSENT REQUIRED 🔥${RESET}\n`);
+    console.log(`${CYAN}----------------------------------------${RESET}`);
+    console.log(`${BOLD}What is claude-agents-md?${RESET}`);
+    console.log(`This package creates a wrapper around the official Claude CLI tool that:`);
+    console.log(`  1. ${RED}Ignores CLAUDE.md${RESET} and uses AGENTS.md instead`);
+    console.log(`  2. Automatically updates to the latest Claude CLI version`);
+    console.log(`  4. ${GREEN}NOW SUPPORTS CLAUDE.md MODE${RESET} with --claude flag\n`);
+
+    console.log(`${BOLD}By using claude-agents-md in AGENTS mode:${RESET}`);
+    console.log(`  • You acknowledge that CLAUDE.md is being ignored and claude will follow instructions from AGENTS.md`);
+    console.log(`  • You accept full responsibility for any rule following implications\n`);
+
+    console.log(`${CYAN}----------------------------------------${RESET}\n`);
+
+    rl.question(`${YELLOW}Do you consent to using claude-agents-md with these modifications? (yes/no): ${RESET}`, (answer) => {
+      rl.close();
+      const lowerAnswer = answer.toLowerCase().trim();
+      if (lowerAnswer === 'yes' || lowerAnswer === 'y') {
+        console.log(`\n${YELLOW}🔥 AGENTS MODE APPROVED 🔥${RESET}`);
+        resolve(true);
+      } else {
+        console.log(`\n${CYAN}Aborted. AGENTS mode not activated.${RESET}`);
+        console.log(`If you want the official Claude CLI with normal behaviour, run:`);
+        console.log(`claude`);
+        resolve(false);
+      }
+    });
+  });
+}
+
+// Get the directory of the current module
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Find node_modules directory by walking up from current file
+let nodeModulesDir = path.resolve(__dirname, '..');
+while (!fs.existsSync(path.join(nodeModulesDir, 'node_modules')) && nodeModulesDir !== '/') {
+  nodeModulesDir = path.resolve(nodeModulesDir, '..');
+}
+
+// Path to check package info
+const packageJsonPath = path.join(nodeModulesDir, 'package.json');
+
+// Check for updates to Claude package
+async function checkForUpdates() {
+  try {
+    debug("Checking for Claude package updates...");
+    
+    // Get the latest version available on npm
+    const latestVersionCmd = "npm view @anthropic-ai/claude-code version";
+    const latestVersion = execSync(latestVersionCmd).toString().trim();
+    debug(`Latest Claude version on npm: ${latestVersion}`);
+    
+    // Get our current installed version
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    const dependencies = packageJson.dependencies || {};
+    const currentVersion = dependencies['@anthropic-ai/claude-code'];
+    
+    debug(`Claude version from package.json: ${currentVersion}`);
+    
+    // Get the global Claude version if available
+    let globalVersion;
+    if (globalClaudeDir) {
+      try {
+        const globalPackageJsonPath = path.join(globalClaudeDir, 'package.json');
+        if (fs.existsSync(globalPackageJsonPath)) {
+          const globalPackageJson = JSON.parse(fs.readFileSync(globalPackageJsonPath, 'utf8'));
+          globalVersion = globalPackageJson.version;
+          debug(`Global Claude version: ${globalVersion}`);
+          
+          // If global version is latest, inform user
+          if (globalVersion === latestVersion) {
+            debug(`Global Claude installation is already the latest version`);
+          } else if (globalVersion && latestVersion) {
+            debug(`Global Claude installation (${globalVersion}) differs from latest (${latestVersion})`);
+          }
+        }
+      } catch (err) {
+        debug(`Error getting global Claude version: ${err.message}`);
+      }
+    }
+    
+    // If using a specific version (not "latest"), and it's out of date, update
+    if (currentVersion !== "latest" && currentVersion !== latestVersion) {
+      console.log(`Updating Claude package from ${currentVersion || 'unknown'} to ${latestVersion}...`);
+      
+      // Update package.json
+      packageJson.dependencies['@anthropic-ai/claude-code'] = latestVersion;
+      fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+      
+      // Run npm install
+      console.log("Running npm install to update dependencies...");
+      execSync("npm install", { stdio: 'inherit', cwd: nodeModulesDir });
+      console.log("Update complete!");
+    } else if (currentVersion === "latest") {
+      // If using "latest", just make sure we have the latest version installed
+      debug("Using 'latest' tag in package.json, running npm install to ensure we have the newest version");
+      execSync("npm install", { stdio: 'inherit', cwd: nodeModulesDir });
+    }
+  } catch (error) {
+    console.error("Error checking for updates:", error.message);
+    debug(error.stack);
+  }
+}
+
+// Try to find global installation of Claude CLI first
+let globalClaudeDir;
+try {
+  const globalNodeModules = execSync('npm -g root').toString().trim();
+  debug(`Global node_modules: ${globalNodeModules}`);
+  const potentialGlobalDir = path.join(globalNodeModules, '@anthropic-ai', 'claude-code');
+  
+  if (fs.existsSync(potentialGlobalDir)) {
+    globalClaudeDir = potentialGlobalDir;
+    debug(`Found global Claude installation at: ${globalClaudeDir}`);
+  }
+} catch (error) {
+  debug(`Error finding global Claude installation: ${error.message}`);
+}
+
+// Path to the local Claude CLI installation
+const localClaudeDir = path.join(nodeModulesDir, 'node_modules', '@anthropic-ai', 'claude-code');
+
+// Prioritize global installation, fall back to local
+const claudeDir = globalClaudeDir || localClaudeDir;
+debug(`Using Claude installation from: ${claudeDir}`);
+debug(`Using ${claudeDir === globalClaudeDir ? 'GLOBAL' : 'LOCAL'} Claude installation`);
+
+// Check for both .js and .mjs versions of the CLI
+let mjs = path.join(claudeDir, 'cli.mjs');
+let js = path.join(claudeDir, 'cli.js');
+let originalCliPath;
+let agentsCliPath;
+
+if (fs.existsSync(js)) {
+  originalCliPath = js;
+  agentsCliPath = path.join(claudeDir, 'cli-agents.js');
+  debug(`Found Claude CLI at ${originalCliPath} (js version)`);
+} else if (fs.existsSync(mjs)) {
+  originalCliPath = mjs;
+  agentsCliPath = path.join(claudeDir, 'cli-agents.mjs');
+  debug(`Found Claude CLI at ${originalCliPath} (mjs version)`);
+} else {
+  console.error(`Error: Claude CLI not found in ${claudeDir}. Make sure @anthropic-ai/claude-code is installed.`);
+  process.exit(1);
+}
+const consentFlagPath = path.join(claudeDir, '.claude-agents-md-consent');
+
+// Main function to run the application
+async function run() {
+  // Handle mode commands first
+  const args = process.argv.slice(2);
+  if (args[0] === 'mode') {
+    if (args[1] === 'agents') {
+      console.log(`${YELLOW}🔥 Switching to AGENTS mode...${RESET}`);
+      console.log(`${RED}⚠️  WARNING: CLAUDE.md will be igored!${RESET}`);
+      setMode('AGENTS');
+      console.log(`${YELLOW}✓ AGENTS mode activated${RESET}`);
+      return;
+    } else if (args[1] === 'claude') {
+      console.log(`${CYAN}🛡️  Switching to CLAUDE.md mode...${RESET}`);
+      console.log(`${GREEN}✓ CLAUDE.md will be enabled${RESET}`);
+      setMode('CLAUDE');
+      console.log(`${CYAN}✓ CLAUDE.md mode activated${RESET}`);
+      return;
+    } else {
+      const currentMode = getMode();
+      console.log(`Current mode: ${currentMode === 'AGENTS' ? YELLOW : CYAN}${currentMode}${RESET}`);
+      return;
+    }
+  }
+
+  // Check for --claude or --no-agents flags
+  const claudeMode = process.argv.includes('--claude') || 
+                   process.argv.includes('--no-agents') ||
+                   getMode() === 'CLAUDE';
+  
+  if (claudeMode) {
+    // Remove our flags before passing to original CLI
+    process.argv = process.argv.filter(arg => 
+      arg !== '--claude' && arg !== '--no-agents'
+    );
+    
+    console.log(`${CYAN}[CLAUDE] Running Claude in CLAUDE.md mode${RESET}`);
+    
+    // Update if needed
+    await checkForUpdates();
+    
+    // Ensure original CLI exists
+    if (!fs.existsSync(originalCliPath)) {
+      console.error(`Error: ${originalCliPath} not found. Make sure @anthropic-ai/claude-code is installed.`);
+      process.exit(1);
+    }
+    
+    // Run original CLI without modifications
+    await import(originalCliPath);
+    return; // Exit early
+  }
+
+  // AGENTS MODE continues below
+  console.log(`${YELLOW}[AGENTS] Running Claude in AGENTS mode${RESET}`);
+  
+  
+  // Check and update Claude package first
+  await checkForUpdates();
+
+  if (!fs.existsSync(originalCliPath)) {
+    console.error(`Error: ${originalCliPath} not found. Make sure @anthropic-ai/claude-code is installed.`);
+    process.exit(1);
+  }
+
+  // Check if consent is needed
+  const consentNeeded = !fs.existsSync(agentsCliPath) || !fs.existsSync(consentFlagPath);
+  
+  // If consent is needed and not already given, ask for it
+  if (consentNeeded) {
+    const consent = await askForConsent();
+    if (!consent) {
+      // User didn't consent, exit
+      process.exit(1);
+    }
+    
+    // Create a flag file to remember that consent was given
+    try {
+      fs.writeFileSync(consentFlagPath, 'consent-given');
+      debug("Created consent flag file");
+    } catch (err) {
+      debug(`Error creating consent flag file: ${err.message}`);
+      // Continue anyway
+    }
+  }
+
+  // Read the original CLI file content
+  let cliContent = fs.readFileSync(originalCliPath, 'utf8');
+
+  if (claudeDir === localClaudeDir) {
+    cliContent = cliContent.replace(/"punycode"/g, '"punycode/"');
+    debug('Replaced all instances of "punycode" with "punycode/"');
+  }
+
+  // Replace CLAUDE.md with AGENTS.md
+  cliContent = cliContent.replace(/CLAUDE.md/gi, 'AGENTS.md');
+  debug("Replaced all instances of CLAUDE.md with AGENTS.md");
+
+  // Add warning message
+  console.log(`${YELLOW}🔥 AGENTS MODE ACTIVATED 🔥${RESET}`);
+
+  // Write the modified content to a new file, leaving the original untouched
+  fs.writeFileSync(agentsCliPath, cliContent);
+  debug(`Created modified CLI at ${agentsCliPath}`);
+  debug("Modifications complete. The AGENTS.md file should now be used instead of CLAUDE.md.");
+
+  // Now import the modified CLI
+  await import(agentsCliPath);
+}
+
+// Run the main function
+run().catch(err => {
+  console.error("Error:", err);
+  process.exit(1);
+});

package/make-agents.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# Script to modify the --dangerously-skip-permissions check in Claude Terminal
+# This will allow the flag to work everywhere by making the Docker and internet checks always return false
+
+# Set the path to the cli.mjs file
+CLI_FILE="${CLAUDE_PATH:-/node_modules/@anthropic-ai/claude-code/cli.mjs}"
+
+# Check if the file exists
+if [ ! -f "$CLI_FILE" ]; then
+  echo "Error: $CLI_FILE not found. Make sure you're running this script from the claude-terminal root directory."
+  exit 1
+fi
+
+# Create a backup of the original file
+cp "$CLI_FILE" "${CLI_FILE}.backup"
+echo "Created backup at ${CLI_FILE}.backup"
+
+# Replace CLAUDE.md with AGENTS.md case insensitively
+sed -i.bak1 's/CLAUDE.md/AGENTS.md/gi' "$CLI_FILE"
+echo "Replaced all instances of CLAUDE.md with AGENTS.md"
+
+# Clean up the .bak file created by sed
+rm -f "${CLI_FILE}.bak1"
+
+echo "Modifications complete. The CLAUDE.md file should now be AGENTS.md."
+echo "To revert changes, restore from the backup file: ${CLI_FILE}.backup" 

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "claude-agents-md",
+  "version": "1.8.0",
+  "description": "Claude Code CLI but it uses AGENTS.md instead of CLAUDE.md",
+  "bin": {
+    "claude-agents-md": "./bin/claude-agents-md.js",
+    "cl": "./bin/cl"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-code": "0.2.35",
+    "punycode": "latest"
+  },
+  "type": "module",
+  "scripts": {
+    "postinstall": "chmod +x ./bin/cl"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eastlondoner/claude-agents-md.git"
+  },
+  "keywords": [
+    "claude",
+    "cli",
+    "anthropic",
+    "wrapper",
+    "agents"
+  ],
+  "author": "eastlondoner",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/eastlondoner/claude-agents-md/issues"
+  },
+  "homepage": "https://github.com/eastlondoner/claude-agents-md#readme",
+  "engines": {
+    "node": ">=14.16"
+  }
+}