n8n node for Claude Code Agent SDK - run AI agents with git worktrees, multi-repo support, and session resume
npm install n8n-nodes-claude-code-agent-loop
n8n community node for running Claude Code agents with native SDK integration.
Features:
- Use your native Claude Code agents (from ~/.claude/agents/)
- Multi-repository support with git worktrees
- Automatic PR creation (Gitea & GitHub)
- Session resume for multi-turn interactions
- Configurable timeouts and turn limits
``bash`
npm install n8n-nodes-claude-code-agent-loop
Or clone and build locally:
`bash`
git clone https://github.com/agi-devops/n8n-nodes-claude-code-agent-loop.git
cd n8n-nodes-claude-code-agent-loop
npm install
npm run build
- Claude Code CLI authenticated (claude command available)~/.claude/agents/
- Agents defined in (see below)~/.claude/skills/
- Skills (optional) in for CLI tool accessgitea
- Git for worktree operations
- Optional: or github CLI for PR creation
This node uses your native Claude Code agents. Create agents as markdown files in ~/.claude/agents/:
`bash`
mkdir -p ~/.claude/agents
`markdown
---
tools: [Read, Write, Edit, Bash, Grep, Glob]
model: claude-sonnet-4-20250514
---Code Reviewer
You are a code review agent. Your task is to review code changes and suggest improvements.
$3
| Field | Description |
|-------|-------------|
|
| Array of allowed tools: [Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch] |
| model | Claude model ID (e.g., claude-sonnet-4-20250514, claude-opus-4-20250514) |Skills (CLI Tools)
Skills provide CLI tools that agents can use. They are automatically loaded from
~/.claude/skills/ and injected into the agent's context.$3
`
~/.claude/skills/
gitea/
SKILL.md # Skill definition
scripts/
gitea # Executable CLI script
youtrack/
SKILL.md
scripts/
youtrack
$3
markdown
---
name: gitea
description: Interacts with Gitea git server. Manages repositories, branches, issues, pull requests, releases, and webhooks. Use when working with Gitea repos.
allowed-tools: Bash
---
Gitea CLI
Execute:
~/.claude/skills/gitea/scripts/gitea Commands
- - List repositories
- repo:create - Create repository
- issues - List issues
- pr:create - Create PR
`$3
| Field | Description |
|-------|-------------|
|
| Skill identifier |
| description | When to use this skill (used for context injection) |
| allowed-tools | Tools the skill needs (e.g., Bash) |
| model | Optional model override |All skills are automatically available to every agent execution.
Node Configuration
$3
| Field | Description |
|-------|-------------|
| Agent Name | Name of your agent (matches
~/.claude/agents/) |$3
Add one or more repositories for the agent to work with:
| Field | Description |
|-------|-------------|
| Name | Unique identifier for this repository |
| Local Path | Absolute path to the local git repository |
| Worktrees Directory | Directory where isolated worktrees will be created |
| Git Provider |
gitea, github, or none (for PR creation) |
| Remote Owner | Organization/user on the git provider |
| Remote Repo | Repository name on the git provider |$3
| Field | Description |
|-------|-------------|
| Prompt | Task description for the agent (max 50KB) |
| Branch Name | Git branch name (auto-generated if empty) |
| Base Branch | Branch to create worktrees from (default:
main) |
| Create Pull Request | Whether to create PR after changes |$3
| Field | Description |
|-------|-------------|
| Model | Claude model to use (can be overridden by agent) |
| Max Turns | Maximum conversation turns (1-200, default: 50) |
| Timeout | Maximum execution time in seconds (10-3600, default: 600) |
$3
| Field | Description |
|-------|-------------|
| Resume Session | Continue from a previous session |
| Session ID | Session ID from previous execution output |
Output
`json
{
"success": true,
"output": "Agent's response text...",
"filesModified": ["/path/to/file1.ts", "/path/to/file2.ts"],
"sessionId": "abc123",
"taskId": "f7e8d9c0",
"branchName": "agent/f7e8d9c0",
"agentName": "code-reviewer",
"prs": [
{
"repo": "my-app",
"number": 42,
"url": "https://github.com/org/my-app/pull/42",
"provider": "github"
}
],
"error": null
}
`n8n Container Setup
When running n8n in Docker, mount your Claude configuration and skills:
yaml
volumes:
- ~/.claude:/home/node/.claude # Agents, skills, and auth
- ~/CLAUDE.md:/home/node/CLAUDE.md:ro # Optional context file
`The node will automatically find:
- Agents at
- Skills at Security
- Uses
instead of exec` to prevent shell injectionMIT