⚡ Sonic Agent

A specialized AI agent for building WordPress authority websites at scale.

Founders cohort license required. This is a private package — install only works with a valid license key.

Install

npm install -g @lebtiga/sonic-agent

You'll be prompted for your license key during install. Format: SONIC-XXXX-XXXX-XXXX-XXXX.

If the prompt is skipped (CI, non-interactive shell), run:

sonic activate

Quick start

sonic              # start the agent in your project directory
sonic init         # scaffold a new project workspace
sonic status       # check install state + license
sonic update       # pull latest core (your skills + user data are preserved)
sonic --help       # all commands

Sonic checks for new versions in the background and shows a one-line notice at launch when an update is available — nothing ever installs without you running sonic update.

🗂️ One folder per client — non-negotiable

Sonic's memory is scoped to the workspace folder it's launched from. Running multiple clients from the same folder causes cross-contamination — Sonic will reference the wrong owner, wrong business, or details from a previous client.

Rule: every new client gets its own folder. Before you start work for a new client:

mkdir -p ~/clients/<client-slug>
cd ~/clients/<client-slug>
sonic

Each client gets clean memory and a clean USER.md automatically — zero cleanup needed.

Physical folder separation is the only reliable way to keep client context isolated. Treat this rule as non-negotiable.

What you get

Sonic installs to ~/.sonic/ with a 3-layer structure:

~/.sonic/
├── sonic-agent/      ← Core agent (refreshed on `sonic update`)
├── sonic-skills/     ← Your installed skills (never touched on update)
└── sonic-user/       ← Your custom skills, client configs, workspace
    ├── custom-skills/
    ├── client-configs/
    └── workspace/

Anything you put in sonic-skills/ or sonic-user/ is yours forever — sonic update will never overwrite it.

Custom skills

Drop your own skills in ~/.sonic/sonic-user/custom-skills/<skill-name>/SKILL.md (plus any supporting files). They load automatically every time Sonic starts, show up under Custom in the boot banner, and survive every sonic update. If a folder name clashes with a built-in Sonic skill, yours is skipped with a warning — rename it to load it.

Requires

• Node.js >= 18
• Claude Code installed (the CLI Sonic plugs into)

Support

• Email: [email protected]
• Docs: https://sonic.saasperity.com

License

Commercial — single seat per license key. Do not redistribute. SOPs and skills are watermarked with the buyer's email for leak detection.