Quickstart / Five explicit steps

From install to a reviewable repository change.

Install Origin, configure the provider you choose, inspect the draft and its receipts, then let a human decide what is ready.

Prerequisites

Python ↗3.11 or newer pipx ↗A current release Provider key ↗Anthropic or OpenRouter

Install the CLI

This installs the devrel command in an isolated Python environment. The published package is devrel-origin.

$pipx install devrel-origin

Implementation detail

If pipx is not available, install it from the official pipx documentation first. Confirm the command with devrel --help.

Initialize the repository

The setup flow creates .devrel/, asks for an Anthropic or OpenRouter provider, stores the provider key in .devrel/.env, and prepares voice and style configuration.

$devrel init

Implementation detail

Project name can be inferred from the Git remote.
The key file is created with restricted file permissions.
Use --skip-chain for scaffolding only or --skip-draft to avoid the first generation call.

Inspect the draft and trace

Each deliverable is saved beside a trace JSON. The trace records grounding sources, code-validation results, and editorial revision notes so reviewers can inspect how the draft was produced.

$open .devrel/deliverables/

Implementation detail

The example set shows this structure using public PostHog materials. A generated status is not a publishing approval. Treat the trace as input to review.

Open the review

Commit the configuration, draft, and trace you intend to keep. Open a pull request and review the marketing diff with the same line comments, requested changes, and merge decision used for code.

$git add .devrel && git commit -m "marketing: add grounded draft" && git push -u origin HEAD

Implementation detail

Review provider-generated text, links, code samples, and competitive claims before merging. Origin does not turn generation into automatic publication.

Tune and operate

Replace the starter voice and style files with approved examples, then add a schedule only when the review process is ready to receive regular drafts.

$devrel schedule install --expression "0 9 * * 1"

Implementation detail

Use devrel doctor for health checks. Read the configure and operate guides before adding unattended runs to a shared repository.