# AI Website Cloner Prerequisites: Node.js 24+ and AI Agent Setup Guide

> Discover the prerequisites for the AI website cloner. Learn how to set up Node.js 24+ and your AI agent for seamless project execution. Docker is optional.

- Repository: [JCodesMore/ai-website-cloner-template](https://github.com/JCodesMore/ai-website-cloner-template)
- Tags: how-to-guide
- Published: 2026-06-27

---

**To run the AI website cloner from JCodesMore/ai-website-cloner-template, you need Node.js 24+ and an installed AI coding agent such as Claude Code or Codex CLI; Docker is optional for containerized execution.**

The AI website cloner is a Next.js 16-based template that relies on an external AI coding agent to handle site inspection, asset extraction, and component generation. Before invoking the `/clone-website` skill, you must satisfy two core prerequisites that drive the modern toolchain and agent integration.

## Core Prerequisites for the AI Website Cloner

### Node.js 24 or Higher

The project requires **Node.js 24+** to support modern ECMAScript features and the Next.js 16 toolchain. The [`package.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/package.json) and [`tsconfig.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/tsconfig.json) files assume this runtime; older versions will break module resolution and TypeScript compilation. This runtime powers the npm scripts, Next.js 16 server, Tailwind CSS v4, shadcn/ui components, and TypeScript compilation.

Download Node.js 24+ from the official Node.js website.

### AI Coding Agent Installation

You must install an **AI coding agent** (e.g., Claude Code, Codex CLI, or GitHub Copilot) to interpret the `/clone-website` skill. The repository ships agent-neutral instructions in [`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md), but the agent must be running to instantiate a headless browser, capture design tokens, and invoke the generation pipeline defined in `scripts/sync-skills.mjs`.

Check the [Supported Platforms section in the README](https://github.com/JCodesMore/ai-website-cloner-template/blob/master/README.md#supported-platforms) for compatible agents and installation guides.

## Optional Docker Setup

If you prefer containerized execution, install **Docker Engine 24+** and the `docker compose` CLI. The repository includes a [`docker-compose.yml`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/docker-compose.yml) file that runs the application on port 3001 with Node.js and Next.js inside a container. This approach eliminates local Node.js version conflicts but still requires an AI agent running outside the container to execute the `/clone-website` skill.

## How Prerequisites Integrate with the Architecture

Node.js drives the **npm** scripts (`npm install`, `npm run dev`, `npm run build`) and provides the runtime environment for the entire stack. Without Node.js 24+, the dependencies listed in [`package.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/package.json) will fail to resolve.

The AI coding agent reads platform-specific skill definitions located at paths like [`.claude/skills/clone-website/SKILL.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/.claude/skills/clone-website/SKILL.md) and [`.github/skills/clone-website/SKILL.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/.github/skills/clone-website/SKILL.md). When you launch the agent (e.g., `claude --chrome`), it reads these files to understand how to drive the browser and generate code according to the instructions in [`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md).

## Step-by-Step Installation Guide

Follow these steps to satisfy the AI website cloner prerequisites:

1. **Verify Node.js 24+**:

```bash
node -v

# Should output v24.x.x or newer

```

2. **Clone the template**:

```bash
git clone https://github.com/YOUR-USERNAME/YOUR-NEW-REPO.git
cd YOUR-NEW-REPO

```

3. **Install dependencies**:

```bash
npm install

```

4. **Launch your AI agent** (Claude Code example):

```bash
claude --chrome

```

5. **Execute the cloning skill**:

```bash
/clone-website https://example.com https://another-site.org

```

*For Docker users:*

```bash
docker compose up dev --build

```

## Key Files Containing Prerequisites

- **[`package.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/package.json)**: Specifies Node.js engine requirements and lists dependencies including Next.js 16, Tailwind CSS v4, and shadcn/ui.
- **[`tsconfig.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/tsconfig.json)**: Configures TypeScript compiler options that assume Node.js 24+ runtime capabilities.
- **[`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md)**: Canonical source for agent instructions that must be kept in sync with platform-specific skill files.
- **[`.claude/skills/clone-website/SKILL.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/.claude/skills/clone-website/SKILL.md)**: Skill definition for Claude Code; similar files exist for other agents in `.github/skills/` and other directories.
- **`scripts/sync-skills.mjs`**: Regenerates the `/clone-website` skill for all supported platforms after [`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md) changes.
- **[`docker-compose.yml`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/docker-compose.yml)**: Configures the containerized development environment requiring Docker Engine 24+.

## Summary

- **Node.js 24+** is mandatory for running the Next.js 16 template and its dependency tree.
- An **AI coding agent** (Claude Code, Codex CLI, etc.) is required to execute the `/clone-website` skill and drive the generation pipeline.
- **Docker 24+** is optional for containerized execution but does not replace the need for an AI agent.
- Critical configuration resides in [`package.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/package.json), [`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md), and platform-specific skill definitions like [`.claude/skills/clone-website/SKILL.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/.claude/skills/clone-website/SKILL.md).

## Frequently Asked Questions

### Can I run the AI website cloner with Node.js 22 or 20?

No. The source code in [`package.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/package.json) and [`tsconfig.json`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/tsconfig.json) assumes Node.js 24+ features and module resolution patterns. Running older versions will break TypeScript compilation and dependency installation.

### Do I need a specific AI agent, or will any work?

The repository supports multiple agents including Claude Code, Codex CLI, and GitHub Copilot. Check the **Supported Platforms** section in the README for the full list. The skill files in directories like [`.claude/skills/clone-website/SKILL.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/.claude/skills/clone-website/SKILL.md) provide agent-specific instructions, but any listed agent can execute the `/clone-website` skill.

### Is Docker required to use the AI website cloner?

No. Docker is optional. You can run the template locally with Node.js 24+ and your preferred AI agent. Docker provides an alternative containerized setup via [`docker-compose.yml`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/docker-compose.yml) for users who prefer isolated environments.

### What happens if I don't have an AI agent installed?

Without an AI coding agent, you cannot invoke the `/clone-website` skill. The agent is responsible for browser automation, design token extraction, and code generation as defined in `scripts/sync-skills.mjs` and [`AGENTS.md`](https://github.com/JCodesMore/ai-website-cloner-template/blob/main/AGENTS.md). You could still run the Next.js application, but the core cloning functionality would be unavailable.