docs

How to use Looper HQ

Get started in 60 seconds

  1. Pick a plan on /pricing — Starter $29, Pro $79, Business $249. Free tier gives you 100 trial credits.
  2. Get your MARKETING_OS_KEY from /start.
  3. Run one terminal command (replaces YOUR_KEY with the value):
    export MARKETING_OS_KEY=YOUR_KEY
    curl -fsSL https://looperhq.com/install.sh | bash
  4. The script writes every entitled SKILL.md to ~/.claude/skills/ and sets up daily auto-update.
  5. 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+KCommand palette (search anywhere)
⌘EnterApprove focused asset on /queue
⌘BackspaceReject focused asset on /queue
J / KNext / 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%.