# Klaudius

> An autonomous web agency, run by AI. It finds local businesses that need a website, builds each one a bespoke site, deploys it, and pitches the owner — end-to-end.

Klaudius is a complete web-agency pipeline driven by Claude Code or Codex. Give it a region and the AI does the work: it finds local businesses with no website — or a dead one, or nothing but a booking-platform page — gathers their content from public sources, builds each one a bespoke Next.js website, deploys it, and sends the outreach and follow-ups that turn a build into a paying client. You direct everything in plain English from inside your agent.

You don't need to be able to code to run it. Non-technical operators run Klaudius as a turnkey business; web designers and agencies run it as a production multiplier. It's region-agnostic — point it at any populated country and it works in the local language.

> **Note:** this npm package contains only the CLI binary. The actual project source — the agent skills, scripts, site template, and database schema — is delivered to your project directory by the `init` command, after your licence key is validated against [klaudius.dev](https://klaudius.dev). Running `npm pack klaudius` or `npm install klaudius` directly will not give you the project source.

## Quick start

```bash
# 1. Get your machine ready — installs Node + Python, skipping what you already
#    have. Paste the line for your OS into Claude Code or Codex:
curl -fsSL https://klaudius.dev/setup.sh | bash      # macOS / Linux
irm https://klaudius.dev/setup.ps1 | iex             # Windows (PowerShell)

# 2. In a new terminal, scaffold the project (prompts for your licence key):
npx klaudius init my-agency

# 3. Operate the pipeline from inside your agent:
cd my-agency
claude                                # or: codex
> Run the pipeline for New Jersey.
```

The setup command installs Node and Python into your user space (no admin password needed), skips anything you already have at a good version, and finishes with a preflight check that points you to `init`. The `init` wizard walks you through everything — your pricing, country and language, outreach channels, deployment host, and the credentials each one needs — then scaffolds the full project, applies the database schema, and installs dependencies. After that you operate the pipeline from inside Claude Code or Codex.

## Commands

`init` and `configure` are the two you type yourself — both open an interactive wizard, so they need a real terminal and your agent can't drive them. The rest you never need to memorise: ask your agent in plain English ("update Klaudius", "check my install is healthy") and it runs them for you. Most `configure`-shaped requests don't need the wizard at all — "change my pricing to $899" or "switch me to Cloudflare Pages" is just an `.env` edit your agent makes directly.

```bash
npx klaudius preflight       # Re-check this machine is ready (Node, Python, pip, npm, network; on Windows also that PowerShell can run npx)
npx klaudius init [target]   # Scaffold a fresh project
npx klaudius configure       # Re-run the setup wizard against an existing project
npx klaudius update          # Pull latest template; conflicts staged for resolution
npx klaudius resolve <file>  # Record a decision on one staged conflict (/resolve-conflicts runs it)
npx klaudius doctor          # Diagnose a broken install (env, files, deps, credentials)
```

## What gets scaffolded

- **Pipeline skills for your agent** — `find`, `gather`, `build`, `deploy`, `outreach`, `follow-up`, `warm-leads`, plus a fresh-eyes `qa-reviewer` agent that independently checks every site before it deploys
- **Upsell skills** that retrofit extras onto a client's live site when they convert — a self-serve CMS, a bespoke booking system, go-live SEO, a live auto-updating Google-rating badge, PDF invoicing
- **A Next.js/Tailwind site template** — the customisable starting point each bespoke client build works from
- **Python and Node scripts** — email senders and readers, adapters for the other outreach channels, database helpers, public-data gathering, deliverability checks
- **A pre-built database schema** for the pipeline's CRM — candidates, statuses, outreach threads, follow-up state
- **The operating manual your agent reads** (`CLAUDE.md` for Claude Code installs, `AGENTS.md` for Codex) plus operator docs (`DOCS.html`, `operator-guide.html`) for you

## Updates

Lifetime updates are included with every licence. Ask your agent to "update Klaudius" and it pulls the latest skills, scripts, and template files, applies everything that's safe to apply, and walks you through anything that needs a decision from you — your own edits are never silently overwritten.

## Prerequisites

- Node 22.15+ and Python 3.10+ (the setup command above installs both if missing)
- An AI coding agent subscription: Claude Code (Anthropic — Pro or Max plan) or Codex (OpenAI — ChatGPT Plus or Pro)
- A free-tier account with the cloud database the pipeline's CRM runs on (the setup wizard names it and walks you through creating the project)
- Somewhere to deploy the sites: Vercel (the default), Cloudflare Pages, or Netlify — free tiers are fine to start — or any server of your own
- An email account to send outreach from — Gmail, Outlook / Microsoft 365, IONOS, Fastmail, Zoho, or Titan (123 Reg / Hostinger / Name.com mail) all work. Klaudius supports further outreach channels beyond email — you opt in and set the priority order during the wizard
- API keys for the public-data sources you want to gather from

Full prerequisites and setup notes at [klaudius.dev](https://klaudius.dev).

## Licence

One-time licence per purchase, granted to a single individual or single entity, with no machine activation limit. You may use Klaudius for your own commercial work, but you may not resell or redistribute the source code. Full terms at [klaudius.dev/terms](https://klaudius.dev/terms).

## Support

Email [hello@klaudius.dev](mailto:hello@klaudius.dev) — you get a detailed, considered reply within 24 hours, usually faster.

## About

More at [klaudius.dev](https://klaudius.dev).