Newsletter

First-run agent command

Install the Newsletter skill before the agent does anything.

Start with one local command. It creates an agent-discoverable skill, keeps setup idempotent, then lets the assistant connect, authenticate, collect profile context, and retrieve a personalized technical brief.

View commands
  • No client secret
  • OAuth device login
  • Authenticated profile storage

Command path

One init command, then the normal CLI flow.

01

Install skill

npx @shivamsharma11/newsletter initDefault personal setup for Codex, Claude Code, OpenCode, and OpenClaw-compatible agents.
02

Project-local option

npx @shivamsharma11/newsletter init --project --allUse when the skill should live with this repo instead of the user's agent profile.
03

Authenticate

newsletter loginOnly run when the CLI reports that OAuth login is needed.
04

Save profile

newsletter profile setup --display-name "<name>" --stack "<stack>" --tools "<tools>" --interests "<interests>"Ask only for missing stack, tools, workflow, and interest details.
05

Get brief

newsletter brief getVerifies the personalized retrieval path after setup.

Init modes

Target every supported agent, or keep it scoped.

Personal default

npx @shivamsharma11/newsletter init

Project skill

npx @shivamsharma11/newsletter init --project --all

Codex only

npx @shivamsharma11/newsletter init --codex

Claude Code only

npx @shivamsharma11/newsletter init --claude-code

OpenCode only

npx @shivamsharma11/newsletter init --opencode

OpenClaw only

npx @shivamsharma11/newsletter init --openclaw

Copy/paste blocks

Run the command, or hand the workflow to your agent.

setup-command.txt

Run this once to create the personal Newsletter skill for supported agents.

npx @shivamsharma11/newsletter init
agent-prompt.txt

Paste this into Codex, Claude Code, OpenCode, OpenClaw, or another assistant.

Set up Newsletter for this assistant from https://shivamsharma.shop/cli/.

For assistants

Read the setup contract.

Agents should visit the CLI page, fetch the Markdown instructions, run init first, then follow the CLI command path. Service URLs are resolved by the CLI runtime.

Open newsletter-agent-setup.md