Quickstart

From install to your first marketing PR.

Five commands. Steps 1–4 ship your first marketing PR; step 5 wires the weekly cron so it keeps running. First draft lands in .devrel/deliverables/, ready to commit.

v0.2.14 · MIT · self-host forever.

Prereqs

Python &nearr;3.11+
pipx &nearr;any recent
An LLM key &nearr;Anthropic or OpenRouter

Step 01

Install.

Adds the devrel binary to your $PATH. The package is devrel-origin; the CLI stays devrel so muscle memory survives.

Step 02

Initialize.

The wizard scaffolds .devrel/, configures your LLM provider, validates the key with a one-token ping, opens voice.md in your editor for samples, then prompts for a topic and content type to generate a first draft via Kai.

Detail+

What the wizard asks

01 Project name — defaults from your git remote
02 LLM provider — Anthropic or OpenRouter (the latter ships with free monthly credits)
03 API key — written to .devrel/.env with chmod 600
04 Voice samples — opens voice.md in $EDITOR ($VISUAL → $EDITOR → first installed of nano/micro/code → vi)
05 Content type + topic — picker accepts a number or exact name: tutorial / blog_post / landing_page / cold_email / battle_card

Want to skip part of the chain? Pass --skip-chain (scaffold only), --skip-draft (everything except the LLM call), or --non-interactive (CI — requires --name).

Step 03

Read the draft.

The deliverable lands in .devrel/deliverables/<iso-week>/<slug>.md with a trace JSON next to it. Every claim is grounded in evidence Kai pulled from your repo: code paths, GitHub issues, KB sources. Open the trace if you want to see the receipts.

Detail+

What the trace JSON tells you

grounding_sources — every KB file Kai pulled from
code_validation — language, blocks scanned, pass/fail per block
revision.strengths / remaining_issues— the editorial pass's notes
pain_points_addressed / real_issues_referenced — Iris themes + Sage issues threaded into the draft

See four real grounded drafts on /docs/examples →

Step 04

Open the PR.

Commit .devrel/and the deliverable, push, open a PR. Review the marketing diff like code: line comments, suggested edits, blocking changes, merge. That's the loop.

Step 05

Tune the voice. Schedule the cycle.

The default voice.md / style.md / slop-blocklist.md ship as starting points. Replace them with three to five samples of your best published writing, your readability targets, and your banned phrases. Then install the weekly cron so Origin runs without you remembering to.

Detail+

Configure tier: /docs/configure covers the four contract files + [llm].agent_models routing. Operate tier: /docs/operate covers cron, health checks via devrel doctor, cost monitoring, and recovery via devrel migrate.

What's next

Go deeper.

// EXAMPLES

From install to your first marketing PR.

Install.

Initialize.

Read the draft.

Open the PR.

Tune the voice. Schedule the cycle.

Go deeper.

Four PostHog-grounded drafts.

Concepts, config, CLI, operate.

The five-step workflow.

Marketing belongs in the repo.

Read the source on GitHub.

What shipped.