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

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 and 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, 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 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 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 will fail to resolve.

The AI coding agent reads platform-specific skill definitions located at paths like .claude/skills/clone-website/SKILL.md and .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.

Step-by-Step Installation Guide

Follow these steps to satisfy the AI website cloner prerequisites:

1. Verify Node.js 24+:

node -v

# Should output v24.x.x or newer

2. Clone the template:

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

3. Install dependencies:

npm install

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

claude --chrome

5. Execute the cloning skill:

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

For Docker users:

docker compose up dev --build

Key Files Containing Prerequisites

• package.json: Specifies Node.js engine requirements and lists dependencies including Next.js 16, Tailwind CSS v4, and shadcn/ui.
• tsconfig.json: Configures TypeScript compiler options that assume Node.js 24+ runtime capabilities.
• AGENTS.md: Canonical source for agent instructions that must be kept in sync with platform-specific skill files.
• .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 changes.
• 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, AGENTS.md, and platform-specific skill definitions like .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 and 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 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 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. You could still run the Next.js application, but the core cloning functionality would be unavailable.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}