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

npx klaudius init my-agency
cd my-agency
claude

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.

Commands

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+ (and Python 3.10+)
• 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.