rhoard

Lean Bun CLI that pulls favorite (liked) articles from Readeck and writes markdown files to knowledge/articles.

What it does

• Reads config from rhoard.config.json in current working directory
• Authenticates with Authorization: Bearer <token>
• Lists favorite bookmarks from /api/bookmarks?is_marked=true
• Fetches full data from /api/bookmarks/sync using with_markdown and with_json
• Saves markdown files as kebab-case title filenames into knowledge/articles
• Rewrites frontmatter to: title, type, date_added, source, author, tags, via (always rhoard)

Config

Create rhoard.config.json from rhoard.config.example.json:

{
  "readeck": {
    "baseUrl": "https://readeck.example.com",
    "apiKey": "your-token",
    "outputDir": "knowledge/articles",
    "pageSize": 100,
    "chunkSize": 50
  }
}

Run

rhoard

Version:

rhoard --version

PM2 (cron_restart)

Use the bundled pm2.rhoard.config.cjs:

pm2 start pm2.rhoard.config.cjs

--pm2-hold keeps the process alive so PM2 cron_restart can restart it on schedule.