whatisgithub

What is capuz?

mauricewipf/capuz — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · developerComplexity · 4/5Setup · hard

In one sentence

Capuz lets an AI chat model read, write, and manage the HTML pages of a static website through a plugin connection, supporting local disk, SFTP, Git, or S3 storage.

Mindmap

mindmap
  root((capuz cms))
    What it does
      AI edits html pages
      MCP tool server
      Draft then publish
      Page management tools
    Tech stack
      Docker
      Open WebUI
      MCP protocol
      SFTP and S3
    Use cases
      Static site editing
      Remote server updates
      Git auto deploy
    Audience
      Site owners
      AI tool builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant in Open WebUI directly edit and publish pages on a hand-written static website.

USE CASE 2

Connect an AI model to a remote server over SFTP so it can update site files without shell access.

USE CASE 3

Auto-deploy AI-made page edits to a Git-hosted static site like GitHub Pages or Netlify.

USE CASE 4

Give an AI tool draft-then-publish control over a site stored in an S3-compatible bucket like Cloudflare R2.

What is it built with?

DockerMCPOpen WebUIHTML

How does it compare?

mauricewipf/capuzamureki/sweatbucksanikchand461/ragbucket
Stars00
LanguageHTMLHTMLHTML
Last pushed2025-08-15
MaintenanceQuiet
Setup difficultyhardeasyeasy
Complexity4/51/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Docker plus setting up storage backend credentials such as SSH keys, Git deploy keys, or S3 access keys.

No license information was found in the README, so usage rights are unclear.

So what is it?

Capuz is a small server that lets an AI chat model directly edit the pages of a static website. It is built as a plugin for Open WebUI, a chat interface, and works through a connection standard called MCP that lets AI models call tools. Once connected, the model can read, write, rename, and delete HTML or XML pages on your site as if it had its own set of editing commands. It is meant for hand-written static sites and landing pages, the kind where the file sitting in storage is exactly what gets served to visitors. It is explicitly not for sites built with frameworks like Next.js, Astro, or Hugo that need a build step before publishing, since those generate their final pages from source files rather than serving them directly. The tool supports four different ways of storing and reaching your site's files. If your site lives on the same server as the cms-api tool itself, it can read and write files directly on disk. If your site is on a separate remote server, it can connect over SFTP using SSH key authentication. If your site is hosted on a static platform like GitHub Pages, Netlify, or Vercel, it can push changes as Git commits, which typically appear live within 20 to 90 seconds. If your site is stored in an S3-compatible bucket such as Cloudflare R2 or AWS S3, changes can go live instantly. The project runs as a Docker container, configured through environment variables that specify which storage method to use and how to reach it. Once running, you connect it to Open WebUI's admin settings as either an MCP tool server or an OpenAPI tool server, authenticated with an API key you generate yourself. Among its available tools are listing published pages and drafts, reading page content, saving a draft version of a page before publishing, making small find-and-replace edits without rewriting a whole page, and moving, renaming, or copying pages while warning about any links that would break.

Copy-paste prompts

Prompt 1
Help me choose the right STORAGE_BACKEND (fs, sftp, git, or s3) for my static site setup with capuz.
Prompt 2
Walk me through setting up SSH key authentication for the sftp storage backend in this project.
Prompt 3
Show me the docker run command to launch cms-api with the git backend pushing to my GitHub Pages repo.
Prompt 4
How do I connect cms-api as an MCP tool server inside Open WebUI's admin settings?
Prompt 5
Explain the difference between write_page, edit_page, and the draft/publish workflow in this tool.

Frequently asked questions

What is capuz?

Capuz lets an AI chat model read, write, and manage the HTML pages of a static website through a plugin connection, supporting local disk, SFTP, Git, or S3 storage.

What language is capuz written in?

Mainly HTML. The stack also includes Docker, MCP, Open WebUI.

What license does capuz use?

No license information was found in the README, so usage rights are unclear.

How hard is capuz to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is capuz for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.