Klaudius

An autonomous web agency, running on Claude Code. Find, build, deploy, outreach — end-to-end.

Klaudius is a Claude Code-driven pipeline for solo developers running a small web design business. Give it a region. It finds local businesses without websites, gathers their content from public sources, builds them bespoke sites, deploys them, and runs the outreach. You direct from inside Claude Code; Klaudius does the work.

One command installs the full pipeline into your project — a Next.js trade-site template, design-system generation skills, lead-sourcing scripts, deployment automation, a Supabase pipeline schema, and email/SMS outreach scaffolding.

Note: this npm package contains only the CLI binary. The actual project source — Claude Code skills, Python scripts, Next.js trade-site template, Supabase schema — is delivered to your project directory by the init command, after your licence key is validated against klaudius.dev. Running npm pack klaudius or npm install klaudius directly will not give you the project source.

Quick start

# 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

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 prompts for credentials (Supabase, Vercel, your email and SMS provider, and a few API keys), scaffolds the full project, applies the database schema, and installs dependencies. After that you operate the pipeline from inside Claude Code or Codex.

Commands

npx klaudius preflight       # Re-check this machine is ready (Node, Python, pip, npm, network)
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 doctor          # Diagnose a broken install (env, files, deps, credentials)

What gets scaffolded

• Next.js trade-site template — a customisable React/Tailwind starting point each generated client site builds from
• Claude Code skills — find, gather, build, deploy, outreach, follow-up, qa-fix, plus a fresh-eyes qa-reviewer agent
• Python scripts — Gmail and IMAP wrappers, iMessage and Twilio adapters, Supabase database helpers, public-data gathering scripts
• Supabase schema — pre-built Postgres schema for tracking project candidates, active client work, and follow-up scheduling
• CLAUDE.md operating manual — the playbook Claude Code reads when you ask it to run the pipeline

Prerequisites

• Node 22.15+ and Python 3.10+ (the setup command above installs both if missing)
• A Claude Code subscription (Pro or Max plan)
• A Supabase project (free tier is fine to start)
• A Vercel team (Hobby tier is fine to start)
• An email and SMS provider — Gmail, Outlook, IONOS, Fastmail, or Zoho for email; iMessage on macOS or Twilio for SMS
• API keys for any public-data sources you want to gather from

Full prerequisites and setup notes at 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.

Support

Email [email protected].

About

More at klaudius.dev.