v0.2.0 — image provider setup and optional theme study

Fixed

Provider keys never reached the MCP server. Both entry points called dotenv.config() with no path, so keys were read from the current working directory — which, for a server an editor launches, is whatever project that editor happens to have open. Stock lookups degraded silently to keyless Lorem Picsum, returning photographs unrelated to the post. Keys now load from ~/.themeseed/.env by absolute path.

Added

• themeseed images configures stock, AI and local image providers at any time: interactive wizard, plus --list, --set, --remove.
• themeseed init now asks which image providers to set up, and writes ~/.themeseed/.env and ~/.themeseed/sites.example.json. Both list every setting, commented out, so they can be filled in by hand. --skip-images skips the prompt.
• imageSource: "none" publishes posts without images; "auto" picks a source from whichever keys are configured.
• studyTheme on generate_posts, and themeseed seed --study-theme, read the active theme and shape content to it.

Changed defaults

Two defaults changed, hence the minor bump:

• imageSource defaults to auto, not stock. With no key configured, posts publish without images rather than with unrelated placeholder photography. Passing stock or ai explicitly still fails loudly when the key is missing.
• Theme analysis no longer runs on every seed. It costs a round trip and now happens only when studyTheme is set, or when analyze_theme / themeseed analyze is called directly.

Install

npm install -g @indianic/themeseed --registry https://npm.indianic.in/
themeseed init

v0.1.1 — Grok, Gemini and fal image adapters

Adds three AI image adapters alongside openai and procedural.

Adapter	Key	Default model
grok	XAI_API_KEY	grok-imagine-image
gemini	GOOGLE_API_KEY	gemini-2.5-flash-image
fal	FAL_KEY	fal-ai/flux/schnell

Whichever key is present is used; THEMESEED_AI_IMAGE_ADAPTER forces one and THEMESEED_AI_IMAGE_MODEL overrides the model. Each backend requests output shape differently, so the theme's measured aspect ratio is snapped onto whatever labels that backend accepts.

Check what works on your machine:

npx tsx scripts/probe-ai-adapters.ts --ratio 1.5

Two gotchas worth knowing: Google image models return 429 immediately unless billing is enabled, and fal keys are <id>:<secret> sent as Authorization: Key …, not Bearer.

v0.1.0 — Ghost provider, MCP server and CLI

First release.

Ghost support end to end: theme analysis, image sourcing, capability-gated content generation, Lexical publishing and tagged cleanup. Full CLI and a 7-tool MCP server.

Install (private registry):

npm config set @indianic:registry https://npm.indianic.in/
npm install -g @indianic/themeseed

See CHANGELOG.md for detail.