social-autoposter 1.0.3 → 1.0.4

package/.env.example

@@ -1,15 +1,11 @@
 # social-autoposter environment variables
-# Copy to .env and fill in your values:
-#   cp .env.example .env
+# This file is created automatically by: npx social-autoposter init
+# Fill in your values and save as .env
 
 # Moltbook API key (required for Moltbook posting/scanning)
 # Get it from: https://www.moltbook.com/settings/api
 MOLTBOOK_API_KEY=
 
-# Neon Postgres connection string (optional — only needed if using syncfield.sh to sync SQLite → Postgres)
-# Get it from: https://console.neon.tech
-DATABASE_URL=
-
-# Google Gemini API key (optional — only needed if using Gemini-based features)
-# Get it from: https://aistudio.google.com/apikey
-GEMINI_API_KEY=
+# Shared Neon Postgres database — pre-filled, read/write access, no delete
+# All social-autoposter users write to this shared DB (used by syncfield.sh)
+DATABASE_URL=postgresql://social_autoposter_public:sap_public_2026@ep-empty-bird-ai7uh8cy-pooler.c-4.us-east-1.aws.neon.tech/neondb?sslmode=require

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "social-autoposter",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Automated social posting pipeline for Reddit, X/Twitter, LinkedIn, and Moltbook. Install as a Claude Code agent skill.",
   "bin": {
     "social-autoposter": "bin/cli.js"

package/setup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: social-autoposter-setup
-description: "Set up social-autoposter for a new user. Interactive wizard that creates the database, configures accounts, verifies browser logins, and optionally sets up scheduled automation. Use when: 'set up social autoposter', 'install social autoposter', 'configure social posting'."
+description: "Set up social-autoposter for a new user. Interactive wizard that installs via npm, creates the database, configures accounts, verifies browser logins, and optionally sets up scheduled automation. Use when: 'set up social autoposter', 'install social autoposter', 'configure social posting'."
 ---
 
 # Social Autoposter Setup
@@ -15,15 +15,18 @@ Interactive setup wizard for social-autoposter. Walk the user through configurat
 
 ## Prerequisites
 
+- Node.js 16+ (for `npx`)
 - `sqlite3` available on PATH
-- A browser automation tool (Playwright MCP, Selenium, etc.) for platform login verification
 - Python 3.9+ for running helper scripts
+- A browser automation tool (Playwright MCP, Selenium, etc.) for platform login verification
+
+---
 
 ## Setup Flow
 
 Run these steps in order. Ask the user for input at each step. Don't skip ahead.
 
-### Step 1: Locate the installation
+### Step 1: Install via npm
 
 Check if already installed:
 
@@ -31,33 +34,41 @@ Check if already installed:
 ls ~/social-autoposter/schema.sql 2>/dev/null && echo "FOUND" || echo "NOT_FOUND"
 ```
 
-If NOT_FOUND, install it:
+If NOT_FOUND, install:
 ```bash
 npx social-autoposter init
 ```
 
-Set `SKILL_DIR` to `~/social-autoposter`.
-
-### Step 2: Create the database
+This copies all scripts, schema, skill files, and config templates to `~/social-autoposter/`. It also:
+- Creates `config.json` from `config.example.json` (if missing)
+- Creates `.env` from `.env.example` (if missing) — includes pre-filled Neon DATABASE_URL
+- Creates `social_posts.db` from `schema.sql` (if missing)
+- Symlinks `~/.claude/skills/social-autoposter` → `~/social-autoposter/skill`
 
+To update scripts later without touching config/data:
 ```bash
-sqlite3 "$SKILL_DIR/social_posts.db" < "$SKILL_DIR/schema.sql"
+npx social-autoposter update
 ```
 
-Verify it worked:
+Set `SKILL_DIR=~/social-autoposter` for the rest of this wizard.
+
+### Step 2: Verify the database
+
 ```bash
 sqlite3 "$SKILL_DIR/social_posts.db" "SELECT name FROM sqlite_master WHERE type='table';"
 ```
 
 Expected tables: `posts`, `threads`, `our_posts`, `thread_comments`, `replies`.
 
-### Step 3: Configure accounts
-
-Copy the example config:
+If missing, create it:
 ```bash
-cp "$SKILL_DIR/config.example.json" "$SKILL_DIR/config.json"
+sqlite3 "$SKILL_DIR/social_posts.db" < "$SKILL_DIR/schema.sql"
 ```
 
+### Step 3: Configure accounts
+
+`config.json` already exists at `$SKILL_DIR/config.json`. Edit it with the user's accounts.
+
 Ask the user for each platform they want to use:
 
 **Reddit:**
@@ -75,8 +86,8 @@ Ask the user for each platform they want to use:
 **Moltbook** (optional):
 - "Do you want to set up Moltbook? (y/n)"
 - If yes: "What's your Moltbook username?" and "What's your Moltbook API key?"
-- Edit `$SKILL_DIR/.env` (template already created from `.env.example`): set `MOLTBOOK_API_KEY=<key>`
-- Set `accounts.moltbook.username` and `accounts.moltbook.api_key_env`
+- Edit `$SKILL_DIR/.env` and set `MOLTBOOK_API_KEY=<key>` (the file already exists from init)
+- Set `accounts.moltbook.username` and `accounts.moltbook.api_key_env` in `config.json`
 
 ### Step 4: Configure content
 
@@ -84,7 +95,7 @@ Ask the user:
 
 **Subreddits:**
 - "Which subreddits do you want to post in? (comma-separated)"
-- Default suggestion: `ClaudeAI, programming, webdev, devops`
+- Default suggestion: `ClaudeAI, ClaudeCode, programming, webdev, devops`
 
 **Content angle:**
 - "Describe your unique experience/perspective in 1-2 sentences. This helps the agent write authentic comments from your point of view."
@@ -102,7 +113,7 @@ For each configured platform, verify the user is logged in:
 **Reddit:**
 - Navigate to `https://old.reddit.com` using browser automation
 - Check if a username appears in the top-right (logged in) or a "login" link (not logged in)
-- If not logged in, tell the user: "Please log into Reddit in your browser, then say 'done'"
+- If not logged in: "Please log into Reddit in your browser, then say 'done'"
 - Re-check after they confirm
 
 **X/Twitter:**
@@ -115,8 +126,12 @@ For each configured platform, verify the user is logged in:
 - Check if the feed loads or a login page appears
 
 **Moltbook:**
-- Test the API key: `curl -s -H "Authorization: Bearer $MOLTBOOK_API_KEY" "https://www.moltbook.com/api/v1/posts?limit=1"`
-- Check for a successful response
+- Source the env file and test the API key:
+  ```bash
+  source ~/social-autoposter/.env
+  curl -s -H "Authorization: Bearer $MOLTBOOK_API_KEY" "https://www.moltbook.com/api/v1/posts?limit=1"
+  ```
+- Check for a successful response (not an auth error)
 
 Report which platforms are ready and which need attention.
 
@@ -129,24 +144,24 @@ python3 "$SKILL_DIR/scripts/find_threads.py" --limit 3
 
 Show the user the candidate threads found. Don't post anything — just verify the pipeline works.
 
-### Step 7: Install the skill
+Rate limit is 40 posts per 24 hours (enforced by the script).
 
-Create the skill symlink so the agent can find it:
-```bash
-mkdir -p ~/.claude/skills
-rm -rf ~/.claude/skills/social-autoposter
-ln -s "$SKILL_DIR" ~/.claude/skills/social-autoposter
-```
-
-### Step 8: Set up automation (optional)
+### Step 7: Set up automation (optional)
 
 Ask: "Do you want posts to run automatically on a schedule? (y/n)"
 
 If yes, and on macOS:
-- Update the launchd plist templates in `$SKILL_DIR/launchd/` with the user's paths
-- Symlink into `~/Library/LaunchAgents/`
-- Load with `launchctl load`
-- Explain: "Posting runs every hour, stats update every 6 hours, reply engagement every 2 hours"
+- The launchd plists are already in `$SKILL_DIR/launchd/`
+- Symlink into `~/Library/LaunchAgents/`:
+  ```bash
+  ln -sf "$SKILL_DIR/launchd/com.m13v.social-autoposter.plist" ~/Library/LaunchAgents/
+  ln -sf "$SKILL_DIR/launchd/com.m13v.social-stats.plist" ~/Library/LaunchAgents/
+  ln -sf "$SKILL_DIR/launchd/com.m13v.social-engage.plist" ~/Library/LaunchAgents/
+  launchctl load ~/Library/LaunchAgents/com.m13v.social-autoposter.plist
+  launchctl load ~/Library/LaunchAgents/com.m13v.social-stats.plist
+  launchctl load ~/Library/LaunchAgents/com.m13v.social-engage.plist
+  ```
+- Schedule: posting runs hourly, stats every 6 hours, reply engagement every 2 hours
 
 If yes, and on Linux:
 - Generate crontab entries:
@@ -158,14 +173,16 @@ If yes, and on Linux:
 
 If no: "You can run manually anytime with `/social-autoposter`"
 
-### Step 9: Summary
+### Step 8: Summary
 
 Print a summary:
 ```
 Social Autoposter Setup Complete
 
+  Installed:   ~/social-autoposter  (v1.0.3 via npm)
   Database:    ~/social-autoposter/social_posts.db
   Config:      ~/social-autoposter/config.json
+  Env:         ~/social-autoposter/.env
   Skill:       ~/.claude/skills/social-autoposter
 
   Platforms:
@@ -174,7 +191,9 @@ Social Autoposter Setup Complete
     LinkedIn:  NAME ✓
     Moltbook:  USERNAME ✓
 
+  Rate limit:  40 posts per 24 hours
   Automation:  launchd (hourly post, 6h stats, 2h engage)
 
   Try it:      /social-autoposter
+  Update:      npx social-autoposter update
 ```