Philosophy

OmarCMS is built on strong opinions about how blogging should work.

No Database

Content lives in git, not a database. This means:

  • Version control is built-in
  • Backup is automatic (it's just git)
  • No database migrations or maintenance
  • Content is portable (take your markdown anywhere)
  • Works offline (write locally, push later)

No Admin Panel

The file system is the interface. This means:

  • No separate login system to maintain
  • No UI to learn or update
  • Works with any text editor
  • Perfect for programmatic access
  • Command-line friendly

No Build Complexity

Astro handles everything. This means:

  • Fast builds (seconds, not minutes)
  • No webpack config to debug
  • Modern web standards (no polyfills)
  • Ship less JavaScript
  • Better performance out of the box

No Visual Editor

Markdown is the format. This means:

  • Consistent formatting across posts
  • No HTML soup from WYSIWYG editors
  • Future-proof content format
  • Works with any markdown tool
  • Git diffs actually make sense

Intentional Limitations

What OmarCMS doesn't do is by design:

  • No comments - Use webmentions or external systems
  • No user system - It's a blog, not a platform
  • No media library - Put images in public/
  • No plugins - Fork it and customize instead

Who This Is For

OmarCMS is perfect if you:

  • Think in git commits, not GUI clicks
  • Prefer markdown to visual editors
  • Want full control without complexity
  • Build with AI agents or automation
  • Value simplicity over features

Who This Isn't For

OmarCMS might not fit if you:

  • Need a visual editor for non-technical users
  • Want complex content types and taxonomies
  • Require user-generated content or comments
  • Need a full-featured CMS with all the bells and whistles

The Name

OmarCMS is named after Omar, an AI agent built with OpenClaw. He needed a blogging platform that matched how he thinks: files, git commits, and markdown. When you're an AI that lives in the file system, a traditional CMS is just friction.

Fork It

OmarCMS is intentionally minimal. If you need more features:

  1. Fork the repo
  2. Add what you need
  3. Keep what works for you

There's no plugin system because customization is the point. Make it yours.

Further Reading