npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@agent-cms/agentcms

v0.4.4

Published

The static CMS your AI agent can run: a WordPress-style admin in the browser that publishes plain HTML to GitHub Pages, Cloudflare Pages, GitLab Pages or any S3-compatible bucket. Installed and managed by Claude Code, Codex, Hermes and other agents.

Readme


Why AgentCMS

Quick start

With an AI agent

Claude Code

/plugin marketplace add fleox/agentcms
/plugin install agentcms@agentcms

Then just ask:

Install a new AgentCMS site on GitHub Pages. Write and publish an article about our spring opening, with the photos in ~/Pictures/spring. Switch to the magazine theme with an orange accent, then add a favicon and enable the RSS feed.

The agent asks where to store the content and where to host the site, then walks you through every token or key. Secrets never go into the chat.

Once the site exists, the back office is a conversation:

| Agent | Setup | |---|---| | Claude Code | the plugin above | | Hermes Agent / Python agents | hermes skills install fleox/agentcms/hermes/skills/agentcms-install (Python wrapper + task scripts, see hermes/) | | Codex, Cursor, Windsurf, any other agent | point it at AGENTS.md |

Without an agent

npx -y @agent-cms/agentcms serve

This starts the admin on your computer (Node.js 20+). Open the printed URL and follow the setup wizard: data → hosting → install. The wizard can also put the admin itself on your site (/admin/), so other editors only need a browser.

More options, including a local build, a hand-made deploy and Firebase, are in docs/self-hosting.md.

Features

Writing

  • Block editor with a slash inserter, drag-and-drop, columns, embeds (YouTube, Vimeo, X, Spotify), custom HTML and theme blocks
  • Posts, pages, categories, tags, authors, menus and a media library with automatic responsive WebP variants
  • Drafts, previews, bulk actions and search, plus Markdown and WordPress import
  • Custom fields on any post or page (header-photo: true, price: 4.5…) that themes and plugins read at publish time

Publishing

  • One click renders the page in your browser and uploads only what changed (content hashing)
  • Clean URLs (/category/post.html), automatic cleanup of renamed paths, and listings kept in sync
  • Every write is one commit on git hosts, so you get one Pages build per action

SEO and reach

  • Canonicals, Open Graph and Twitter cards, per-term SEO, sitemaps (including News), robots.txt and RSS feeds
  • Multi-language sites: per-language URLs, editor tabs, menus, hreflang, sitemaps and feeds
  • Static search, archives and a favicon/PWA generator

Extensible

  • 5 themes and a dozen plugins included; install more as ZIP packages from the admin without rebuilding it
  • WordPress-style hooks (filters and actions) and a typed runtime API
  • agentcms ext scaffolds, checks, previews (with screenshots) and ships your own plugins and themes

Safe by design

  • Secrets (git tokens, S3 keys, passphrases) stay in each editor's browser or in the CLI's 0600 credentials file, never in the site or the repo
  • SQLite databases are AES-256-GCM encrypted by default
  • The admin UI is available in 7 languages: English, French, German, Spanish, Dutch, Portuguese and Korean

Themes

Every theme below is a real rendering of the bundled demo content, made by the publisher itself.

How it works

The admin is the only runtime. When you click Publish, it reads the content and renders the page with the active theme (renderToStaticMarkup), right in the browser. It then uploads the HTML, together with every listing that depends on it, through the selected hosting connector. The data backend (where content lives) and the hosting (where the site is served) are independent choices:

| Data backend | Good for | Accounts | |---|---|---| | SQLite file (default) | One owner, the simplest setup. Encrypted file on your own hosting. | none | | Markdown in git | Teams. Every change is a commit, and editors use their own GitHub / GitLab token. | repository permissions | | Firebase | Real-time multi-editor work. Free tier. Illustrated setup. | Firebase Auth | | This browser | Trying things out, single user. | none |

Hostings: GitHub Pages, Cloudflare Pages, GitLab Pages, any git-deployed host (Netlify, Vercel…), S3-compatible buckets (AWS, R2, OVH, Scaleway…), a local folder, or a ZIP to upload yourself. See docs/publish-targets.md.

How AgentCMS compares

| | AgentCMS | WordPress | Static site generators | Headless CMS | |---|---|---|---|---| | Visual admin for editors | ✅ | ✅ | ❌ (files + CLI) | ✅ | | Public site is static files | ✅ | ❌ | ✅ | depends on your front end | | Server or database to maintain | ❌ | ✅ | ❌ | ✅ (or SaaS) | | Build pipeline to set up | ❌ | ❌ | ✅ | ✅ | | Content stays on your own storage | ✅ | ✅ | ✅ | usually SaaS | | Fully drivable by an AI agent | ✅ | partial | partial | partial |

The agentcms CLI

The same engine the agents use, also available by hand: npx -y @agent-cms/agentcms help. Every command supports --json, and destructive commands print a plan until you add --yes.

| Command | What it does | |---|---| | status | This tool vs the latest release, and every registered site's admin version | | options | Data backends, hostings and the install plan format | | credentials set <type>:<name> | Stores a token / key per account (hidden prompt, --from-gh, --from-aws-profile, --from-env) | | install --plan plan.json | Installs a site (content store, publish target, theme assets, admin); --dry-run only checks | | site list \| add \| use \| rename \| forget | The sites this computer manages | | doctor --site <alias> | Health check with a fix for each problem | | deploy-admin --site <alias> | Updates the hosted admin to this release | | serve | Runs the admin locally for the setup wizard | | content list \| get \| create \| update \| publish \| unpublish \| delete \| preview \| blocks | Posts and pages, like the editor (Markdown, blocks, images, SEO, translations) | | media list \| upload \| update \| delete | Media library (the admin's image pipeline, in Node) | | terms, menus, settings, users | Categories & tags, menus, site settings, users and author profiles | | plugins list \| enable \| disable \| config \| action | Plugins and their settings-page buttons | | themes list \| activate \| config \| logo | Themes, their settings and logo | | regenerate home \| all \| repair \| assets \| everything | The admin's Regenerate menu | | transfer export \| import, stats | Content export / import, dashboard numbers | | ext new \| check \| preview \| pack \| install | Build, test and ship plugins and themes |

Build a plugin or theme

Plugins and themes are standalone projects that build into a single ZIP. You install that ZIP from the admin (Plugins / Themes → Install), with no admin rebuild.

npx -y @agent-cms/agentcms ext new theme my-theme   # or: ext new plugin my-plugin
cd my-theme && npm install
npm run check      # validates it and renders a demo site through the real publisher
npm run preview    # demo site + desktop / mobile screenshots

Guides: creating a plugin · creating a theme · runtime API. With Claude Code, the agentcms-extensions skill drives the whole loop.

Documentation

| | | |---|---| | Publish targets | Every hosting option, its setup and its limits | | Self-hosting | Setup wizard, local build, deploying and protecting the admin | | Firebase | Console setup step by step (screenshots), security rules and indexes | | Themes and plugins | How they work, and every built-in plugin | | Architecture | Publish pipeline, URLs, menus, images, i18n, code layout | | AGENTS.md | Instructions for AI agents |

Contributing

Bug reports and ideas are welcome: open an issue. Read CONTRIBUTING.md before opening a pull request. For security issues, follow SECURITY.md instead of opening a public issue.

npm install --legacy-peer-deps
npm run dev        # admin at http://localhost:5173
npm test           # Vitest
npm run build      # typecheck + admin + themes + CLI

License

Source-available under the PolyForm Noncommercial License 1.0.0. Personal, hobbyist, educational, research and other noncommercial use is free, and you can fork, modify and redistribute under the same terms.

Commercial use requires written authorization. This includes selling the software or hosting it as a paid service. For a commercial license, open an issue.