@sureliving/n8n-nodes-claudecode 0.1.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2022 n8n
+
+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,362 @@
+# 🚀 Claude Code for n8n
+
+**Bring the power of Claude Code directly into your n8n automation workflows!**
+
+Imagine having an AI coding assistant that can analyze your codebase, fix bugs, write new features, manage databases, interact with APIs, and automate your entire development workflow - all within n8n. That's exactly what this node enables.
+
+[![n8n](https://img.shields.io/badge/n8n-community_node-orange.svg)](https://n8n.io/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Powered-blue.svg)](https://claude.ai/code)
+[![npm](https://img.shields.io/npm/v/@sureliving/n8n-nodes-claudecode.svg)](https://www.npmjs.com/package/@sureliving/n8n-nodes-claudecode)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.md)
+
+## 🌟 What Can You Build?
+
+### 🔧 **Automated Code Reviews**
+Create workflows that automatically review pull requests, suggest improvements, and even fix issues before merging.
+
+### 🐛 **Intelligent Bug Fixing**
+Connect error monitoring tools to Claude Code - automatically diagnose and fix production issues in real-time.
+
+### 📊 **Database Management**
+Let Claude Code write complex SQL queries, optimize database schemas, and generate migration scripts based on your requirements.
+
+### 🤖 **Self-Improving Workflows**
+Build n8n workflows that can modify and improve themselves using Claude Code's capabilities.
+
+### 📝 **Documentation Generation**
+Automatically generate and update documentation for your entire codebase, APIs, or databases.
+
+### 🔄 **Code Migration**
+Automate the migration of legacy codebases to modern frameworks with intelligent refactoring.
+
+### 🎫 **Customer Support Automation**
+Transform support tickets into code fixes automatically:
+- Analyze customer bug reports and reproduce issues
+- Generate fixes for reported problems
+- Create test cases to prevent regression
+- Update documentation based on common questions
+- Auto-respond with workarounds while fixes are deployed
+
+## ⚡ Quick Start
+
+### Prerequisites
+1. **Claude Code runtime**
+
+This node uses `@anthropic-ai/claude-agent-sdk`, which bundles a Node-based Claude Code entrypoint. You do **not** need a global `claude` binary in `$PATH` for the node to run.
+
+If you prefer using the native Claude Code binary/installer instead, install it on your n8n server and configure the SDK accordingly.
+
+2. **Authentication**
+
+You can authenticate in two ways:
+
+- **n8n Credentials (required)**: Create an **Anthropic API** credential in n8n and select it on the Claude Code node. The API key is injected only into the spawned Claude Code process environment for that execution. The node intentionally strips any Claude/Anthropic auth environment variables from the container environment to ensure auth comes only from n8n credentials.
+
+### Install in n8n
+
+#### Option 1: Via n8n UI (Recommended)
+1. Open your n8n instance
+2. Go to **Settings** → **Community Nodes**
+3. Click **Install a community node**
+4. Enter: `@sureliving/n8n-nodes-claudecode`
+5. Click **Install**
+6. Restart n8n when prompted
+
+#### Option 2: Manual Installation
+```bash
+cd ~/.n8n/nodes
+npm install @sureliving/n8n-nodes-claudecode
+# Restart n8n
+```
+
+#### Option 3: Docker
+```bash
+docker run -it --rm \
+  -p 5678:5678 \
+  -e N8N_COMMUNITY_NODE_PACKAGES=@sureliving/n8n-nodes-claudecode \
+  -v ~/.n8n:/home/node/.n8n \
+  n8nio/n8n
+```
+
+**Note**: For Docker, you'll need to ensure Claude Code CLI is installed inside the container. Consider creating a custom Dockerfile.
+
+📦 **NPM Package**: [@sureliving/n8n-nodes-claudecode](https://www.npmjs.com/package/@sureliving/n8n-nodes-claudecode)
+
+## 🎯 Real-World Use Cases
+
+### 1. **GitHub Issue to Code**
+```
+Webhook (GitHub Issue) → Claude Code → Create PR → Notify Slack
+```
+Automatically implement features or fix bugs when issues are created.
+
+### 2. **Database Query Builder**
+```
+Form Trigger → Claude Code → Execute Query → Send Results
+```
+Natural language to SQL - let non-technical users query databases safely.
+
+### 3. **Code Quality Guardian**
+```
+Git Push → Claude Code → Analyze Code → Block/Approve → Notify
+```
+Enforce coding standards and catch issues before they reach production.
+
+### 4. **API Integration Builder**
+```
+HTTP Request → Claude Code → Generate Integration → Test → Deploy
+```
+Automatically create integrations with third-party APIs.
+
+### 5. **Intelligent Log Analysis**
+```
+Error Logs → Claude Code → Diagnose → Create Fix → Open PR
+```
+Turn error logs into actionable fixes automatically.
+
+### 6. **Customer Support to Code Fix**
+```
+Support Ticket → Claude Code → Reproduce Issue → Generate Fix → Test → Deploy → Auto-Reply
+```
+Transform customer complaints into deployed fixes in minutes, not days.
+
+## 🛠️ Powerful Features
+
+### **Project Context Awareness**
+Set a project path and Claude Code understands your entire codebase context:
+- Analyzes existing code patterns
+- Follows your coding standards
+- Understands your architecture
+- Respects your dependencies
+
+### **Tool Arsenal**
+Claude Code comes equipped with powerful tools:
+- 📁 **File Operations**: Read, write, edit multiple files
+- 💻 **Bash Commands**: Execute any command
+- 🔍 **Smart Search**: Find patterns across your codebase
+- 🌐 **Web Access**: Fetch documentation and resources
+- 📊 **Database Access**: Via MCP servers
+- 🔗 **API Integration**: GitHub, Slack, and more via MCP
+
+### **Advanced SDK Options**
+Fine-tune Claude Code's behavior with these powerful options:
+- 🚫 **Disallowed Tools**: Explicitly block specific tools for security
+- 🔄 **Fallback Model**: Automatically switch models when primary is overloaded
+- 🧠 **Max Thinking Tokens**: Control Claude's internal reasoning depth
+- 🔐 **Permission Modes**: Choose from `default`, `acceptEdits`, `bypassPermissions`, or `plan`
+
+### **Model Context Protocol (MCP)**
+Extend Claude Code with specialized capabilities:
+- PostgreSQL/MySQL database access
+- GitHub repository management
+- Slack workspace integration
+- Custom tool development
+
+## 📋 Configuration Examples
+
+### Simple Code Analysis
+```javascript
+{
+  "operation": "query",
+  "prompt": "Analyze this codebase and suggest performance improvements",
+  "projectPath": "/path/to/your/project",
+  "model": "sonnet"
+}
+```
+
+### Advanced Database Operations
+```javascript
+{
+  "operation": "query",
+  "prompt": "Create an optimized query to find users who haven't logged in for 30 days",
+  "projectPath": "/path/to/project",
+  "model": "opus"
+}
+```
+
+### Customer Support Automation
+```javascript
+{
+  "operation": "query",
+  "prompt": "Customer reports: 'Login button not working on mobile devices'\n\nAnalyze this issue, find the root cause, and create a fix",
+  "projectPath": "/path/to/web-app",
+  "model": "opus",
+  "allowedTools": ["Read", "Write", "Edit", "Bash", "Grep"],
+  "additionalOptions": {
+    "systemPrompt": "Focus on mobile compatibility issues. Check responsive CSS and JavaScript event handlers."
+  }
+}
+```
+
+### Advanced Configuration with SDK Options
+```javascript
+{
+  "operation": "query",
+  "prompt": "Refactor this legacy code to use modern patterns",
+  "projectPath": "/path/to/legacy-app",
+  "model": "opus",
+  "allowedTools": ["Read", "Write", "Edit", "MultiEdit", "Grep"],
+  "disallowedTools": ["Bash"],  // Prevent command execution for safety
+  "additionalOptions": {
+    "permissionMode": "plan",  // Claude will plan before executing
+    "fallbackModel": "sonnet",  // Auto-switch if Opus is overloaded
+    "maxThinkingTokens": 50000,  // Allow deep reasoning for complex refactoring
+    "systemPrompt": "Preserve all existing functionality while modernizing the code"
+  }
+}
+```
+
+With MCP configuration (`.mcp.json`):
+```json
+{
+  "mcpServers": {
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
+    }
+  }
+}
+```
+
+## 🔄 Workflow Patterns
+
+### Pattern 1: Continuous Code Improvement
+```
+Schedule Trigger (Daily)
+  ↓
+Claude Code (Analyze codebase for improvements)
+  ↓
+Create GitHub Issues
+  ↓
+Assign to Team
+```
+
+### Pattern 2: Natural Language to Code
+```
+Slack Command
+  ↓
+Claude Code (Generate code from description)
+  ↓
+Create Pull Request
+  ↓
+Run Tests
+  ↓
+Notify Results
+```
+
+### Pattern 3: Intelligent Monitoring
+```
+Error Webhook
+  ↓
+Claude Code (Diagnose issue)
+  ↓
+If (Can fix automatically)
+  ├─ Yes: Create Fix PR
+  └─ No: Create Detailed Issue
+```
+
+## 🚦 Getting Started
+
+### 1. **Verify Prerequisites**
+Make sure Claude Code CLI is installed and authenticated on your n8n server:
+```bash
+claude --version  # Should show the version
+```
+
+If not installed, see the [Quick Start](#-quick-start) section above.
+
+### 2. **Create Your First Workflow**
+1. In n8n, create a new workflow
+2. Add a **Manual Trigger** node (for testing)
+3. Add the **Claude Code** node
+4. Configure:
+   - **Operation**: Query
+   - **Prompt**: "Analyze the code in this directory and suggest improvements"
+   - **Project Path**: `/path/to/your/project`
+   - **Model**: Sonnet (faster) or Opus (more powerful)
+5. Click **Execute Workflow**
+6. Watch Claude Code analyze your project!
+
+### 3. **Explore Advanced Features**
+- Check out the [workflow templates](./workflow-templates/) for ready-to-use examples
+- See the [examples directory](./examples/) for configuration options
+- Read about [MCP servers](#model-context-protocol-mcp) for database and API access
+
+## 💡 Pro Tips
+
+### 🎯 **Use Project Paths**
+Always set a project path for better context and results:
+```
+/home/user/projects/my-app
+```
+
+### 🔒 **Configure Permissions**
+Control what Claude Code can do in `.claude/settings.json`:
+```json
+{
+  "permissions": {
+    "allow": ["Read(*)", "Write(*)", "Bash(npm test)"],
+    "deny": ["Bash(rm -rf *)"]
+  }
+}
+```
+
+### 🔗 **Chain Operations**
+Use "Continue" operation to build complex multi-step workflows while maintaining context.
+
+### 📊 **Output Formats**
+- **Structured**: Full details with metrics
+- **Messages**: For debugging
+- **Text**: Simple results for chaining
+
+## 🤝 Community & Support
+
+- 📖 [Documentation](https://github.com/johnlindquist/n8n-nodes-claudecode)
+- 🐛 [Report Issues](https://github.com/johnlindquist/n8n-nodes-claudecode/issues)
+- 💬 [Discussions](https://github.com/johnlindquist/n8n-nodes-claudecode/discussions)
+- 🌟 [Star on GitHub](https://github.com/johnlindquist/n8n-nodes-claudecode)
+
+## 📈 What's Next?
+
+We're constantly improving! Upcoming features:
+- Visual workflow builder for Claude Code operations
+- Pre-built workflow templates
+- Enhanced debugging tools
+- More MCP server integrations
+
+## 🔄 Development & Contributing
+
+### Commit Conventions
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/) and automated semantic versioning:
+
+- `feat:` New features (minor version bump)
+- `fix:` Bug fixes (patch version bump)
+- `docs:` Documentation changes
+- `chore:` Maintenance tasks
+- `test:` Adding or updating tests
+
+Use `npm run commit` for an interactive commit message builder.
+
+### Release Process
+
+Releases are **fully automated** using semantic-release:
+1. Push commits to `main` branch
+2. CI analyzes commit messages
+3. Version is automatically bumped based on commit types
+4. Package is published to npm
+5. GitHub release is created with changelog
+
+No manual version management required!
+
+## 📄 License
+
+MIT - Build amazing things!
+
+---
+
+**Ready to revolutionize your development workflow?** Install Claude Code for n8n today and join the future of automated software development!
+
+Originally created by [Adam Holt](https://github.com/holt-web-ai) - [Original Repository](https://github.com/holt-web-ai/n8n-nodes-claudecode)
+
+Forked and maintained by [John Lindquist](https://github.com/johnlindquist)

package/dist/credentials/AnthropicApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class AnthropicApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/AnthropicApi.credentials.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicApi = void 0;
+class AnthropicApi {
+    constructor() {
+        this.name = 'anthropicApi';
+        this.displayName = 'Anthropic API';
+        this.documentationUrl = 'https://docs.anthropic.com/en/api/getting-started';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+            },
+        ];
+    }
+}
+exports.AnthropicApi = AnthropicApi;
+//# sourceMappingURL=AnthropicApi.credentials.js.map

package/dist/credentials/AnthropicApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicApi.credentials.js","sourceRoot":"","sources":["../../credentials/AnthropicApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IAAzB;QACC,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,eAAe,CAAC;QAC9B,qBAAgB,GAAG,mDAAmD,CAAC;QAEvE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;IACH,CAAC;CAAA;AAjBD,oCAiBC"}

package/dist/nodes/ClaudeCode/ClaudeCode.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ClaudeCode implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}