docs
How to use Looper HQ
Get started in 60 seconds
- Pick a plan on /pricing — Starter $29, Pro $79, Business $249. Free tier gives you 100 trial credits.
- Get your
MARKETING_OS_KEYfrom /start. - Run one terminal command (replaces YOUR_KEY with the value):
export MARKETING_OS_KEY=YOUR_KEY curl -fsSL https://looperhq.com/install.sh | bash
- The script writes every entitled SKILL.md to
~/.claude/skills/and sets up daily auto-update. - Open Claude Code. Talk normally. Skills auto-load when descriptions match your prompt.
How skills work
A skill is a markdown file with YAML frontmatter. Claude Code reads its description and silently loads the skill when your prompt matches.
You never type a command. Just describe what you want. If you say "draft a LinkedIn post about Epic certification" and you have linkedin-long-form and epic-go-live-context installed, both load. Output reflects both.
Skills stack. They never override each other. The more relevant skills you have installed, the richer your output.
Settings + management
- /dashboard shows what fired today, top skills, pending recommendations.
- /tools is your installed catalog. Click any to see the explainer + effectiveness analytics + voting.
- /automations has kill switches for every recurring routine. Toggle off if a cost spike worries you.
- /recommendations is the Recommender Routine output. Accept or reject in one click.
- /admin/products edits brand voice and ICP per product. Subagents read this.
Keyboard shortcuts
| ⌘K / Ctrl+K | Command palette (search anywhere) |
| ⌘Enter | Approve focused asset on /queue |
| ⌘Backspace | Reject focused asset on /queue |
| J / K | Next / previous asset on /queue |
| ? | Show this shortcut list |
Troubleshooting
Skills not loading in Claude Code
Run ls ~/.claude/skills/. You should see folders. If not, re-run the install command. Skills in the wrong path (anywhere outside ~/.claude/skills/<name>/SKILL.md) will not auto-load.
Getting "permission denied" on /api endpoints
Sign in via the magic link at /login. Owner-only endpoints check your authenticated email matches OWNER_EMAIL. If you keep getting magic links burned by Gmail's preview scanner, request a fresh one and click within 30 seconds.
Telemetry counter not incrementing
The hook fires on Claude Code SessionEnd. Telemetry only increments after you close a session. Run a session that uses one of your skills, exit, then refresh the /tools/[id] page.
Cost spike I did not expect
Open /automations and toggle anything OFF. The Recommender Routine writes a budget_shift recommendation when actual spend exceeds estimated by 50%.