← Back to Documentation

Using AI Tools to Manage Your Site

A WebHaste site is comprised of HTML files on your device — which means Claude Code and other AI coding tools can read, edit, and even preview the site directly.

Every new WebHaste project is scaffolded with a CLAUDE.md file at its root. It's written specifically to brief an AI agent on this site's conventions — fragment pages, template placeholders, how nav.json/pages.json wire pages together, the block format, and so on — so a fresh agent session already understands the format before you ask it to do anything. You never have to explain WebHaste to it from scratch.

🔎Claude Code in an IDE or terminal

Open your site's project folder as the workspace root (in VS Code, a JetBrains IDE, or a plain terminal) and Claude Code will automatically discover and read the root CLAUDE.md. From there you can ask it to do the same things you'd do by hand in the extension. 

Some examples:

Because a page file is a body-content fragment, not a full HTML document, an agent can't just open the page in a browser to check its work — it needs the template/nav substitution applied first. Every project ships with .webhaste/compose.js to do exactly that headlessly:

node .webhaste/compose.js --out .agent-preview

That writes fully composed pages into a scratch folder inside your project, matching what "Render to Local Folder" or Publish would actually produce. Ask the agent to run this after making changes, then open the result in a browser to check it — and to delete the scratch folder when it's done, since it's not meant to be committed.

Some config files are regenerated every time you open the project in the extension, so edits an agent makes to them won't stick: .webhaste/compose.js, .webhaste/compose-core.js, and .webhaste/block-library.md. If you ask an agent to change how a block looks or add a new built-in one, point it at the extension's block system rather than a generated file.

💻AI Desktop apps

Most AI desktop apps don't have direct filesystem access — it's chat-only unless you connect a local filesystem MCP server pointed at your site's folder (Settings → Connectors). Without that, a desktop app is still useful for the parts of site work that don't need direct access: drafting page copy, brainstorming a page's structure or a new block's content, or reviewing a pasted-in nav.json/page fragment and suggesting edits you copy back by hand.

With a filesystem MCP server connected, your desktop app can read and write your project the same way Claude Code does, including running compose.js if the connector allows shell access.

Other AI coding tools

Cursor, Windsurf, GitHub Copilot Chat, and similar tools work the same way in principle — they read and write real files, and most look for a root instructions file to pick up project conventions automatically. If a particular tool doesn't recognize CLAUDE.md on its own, you can usually point it at the file directly, or copy the relevant sections into whatever instructions file it does expect.

❌What AI tools can't do


💡Prompt cheat sheet

Once you're up and running with a local AI agent to directly edit your site, here are a few prompts to get started:


🤖Hosted AI/content tools (Sintra, Marblism, Grammarly, etc.)

Hosted AI services or writing tools are typcially not local agents that can open your project folder directly, so they can't read CLAUDE.md, site.config.json, or anything else the way Claude Code can or even make direct changes. But similar to a desktop AI app with no MCP connector, you can use these services to help create/manage/improve your site's content via copy-paste.

What helps is telling the remote tool, directly in the prompt, the handful of facts a local agent would need to look up:

Paste the content provided by your service directly into WebHaste's Code view rather than Visual view — hosted tools may add extra wrapper <div>s or inline styles, and Code view is where you can clean that up before it becomes part of the page. Since the tool never saw your real template, always check the result in Live Preview afterward rather than trusting it sight unseen.

If your service is consistently adding inline style definitions or unwanted structure, prompt it to provide content with only basic HTML tags like p, br, ul, ol, strong, and em.

If you have an existing page and want your hosted service to make changes, you can copy the entire contents of that page in code view and paste that directly into the external tool's chat, coupled with your prompt. For example:

"Rewrite the HTML content below to summarize key concepts as groups of bullet points, and check to make sure the result has a Flesch reading score of 70 or lower. Return the edited page as an HTML stub similar to what is provided: <pasted page code here>"

Copy or download the edited HTML code to paste back into WebHaste in code view.

Additionally, these services typically are able to provide SEO-optimized titles, meta descriptions and summaries that you can paste into WebHaste, as well as generate social media posts to promote your site.