AI Agent for Your Static Site

Let Claude write content, generate themes, debug builds, and manage your static site generator project, all with full project context. No API keys required.

Most static site generators treat AI as an afterthought: a plugin, a separate API call, a bolted-on chatbot. seite takes a different approach. The seite agent command gives Claude Code full context about your site's configuration, content, templates, and conventions. It reads your project, understands the structure, and writes files that actually fit. No other static site generator ships with this kind of native AI integration.

Overview

seite integrates directly with Claude Code. The seite agent command spawns a Claude Code session pre-loaded with your site's full context: configuration, content inventory, templates, and available commands. This context is also exposed to other AI tools through the MCP server, so your site stays AI-accessible beyond just the agent.

No API keys needed. It uses your Claude Code subscription directly.

Setup

Install Claude Code (see the getting started guide if you haven't set up your project yet):

npm install -g @anthropic-ai/claude-code

Verify it's available:

claude --version

Interactive Mode

Launch an interactive session:

seite agent

Claude receives a rich system prompt containing:

  • Your site config (title, description, base URL, collections)
  • Content inventory (titles, dates, tags of every existing page)
  • Available templates
  • Frontmatter format with examples
  • File naming conventions
  • All seite CLI commands

You can ask it to write blog posts, reorganize content, update templates, debug build errors, or anything else.

Info

The agent can run seite build and seite serve to verify its own changes. It will catch build errors, broken links, and template issues before you even look at the output.

One-Shot Mode

Pass a prompt directly for non-interactive use:

seite agent "create a blog post about Rust error handling best practices"
seite agent "add a docs page explaining the deployment process"
seite agent "update the homepage to include a features section"

Claude writes the files directly and exits.

Example Prompts

Here are prompts that work well, grouped by use case:

Content creation

seite agent "write a technical tutorial about async Rust, include code examples and a summary"
seite agent "create a blog post comparing static site generators, with a table of features"
seite agent "add an FAQ page with 10 common questions about our product"

Site management

seite agent "add the tag 'tutorial' to all posts that contain code blocks"
seite agent "create Spanish translations for all docs pages"
seite agent "reorganize the docs into guides/ and reference/ subdirectories"

Theme and design

seite agent "update the homepage to add a testimonials section with three cards"
seite agent "add a custom footer with social links and a newsletter signup"

Debugging

seite agent "the build is failing on my Spanish translations, help me fix it"
seite agent "find and fix any broken internal links in my content"
seite agent "my RSS feed is missing some posts, diagnose the issue"

Tips for Effective Prompts

Tip

Be specific about format and tone. "Write a 1500-word technical tutorial about Rust error handling with code examples" gives better results than "write a post about Rust".

Tip

The agent already knows your site structure, collections, existing content, and frontmatter format. You don't need to explain where files go or what fields to include, just describe what you want.

Theme Generation

Generate custom themes with AI:

seite theme create "dark mode with neon green accents and brutalist layout"

Claude receives detailed instructions about required template blocks, available variables, SEO requirements, search patterns, and accessibility features. It writes templates/base.html directly. For more on themes, see the theme gallery.

REPL Integration

The dev server REPL also supports the agent:

seite> agent "write a post about our latest release"

This is useful for quick content creation while previewing your site.

What the Agent Can Do

The agent has access to these tools:

  • Read: read any file in your project
  • Write: create new content files
  • Edit: modify existing files
  • Glob: find files by pattern
  • Grep: search file contents
  • Bash: run CLI commands (build, serve, deploy)

Concrete example: writing a blog post

Without the agent, creating a well-structured post means remembering the frontmatter format, putting the file in the right directory with the right filename pattern, picking appropriate tags from your existing taxonomy, and making sure the description is under 160 characters for SEO.

With the agent, you say:

seite agent "write a post about our new pricing model, mention the 3 tiers, \
  keep the tone conversational, and tag it appropriately"

The agent checks your existing posts for tone and tag conventions, creates content/posts/2026-03-13-new-pricing-model.md with correct frontmatter (title, date, description, tags), writes the body matching your site's voice, and runs seite build to verify everything compiles cleanly. One command, no manual scaffolding.

How It Compares

Other static site generators require you to set up AI workflows yourself: connect to an LLM API, write prompts that describe your project structure, and hope the output matches your conventions. If your site uses Hugo, you need to explain Hugo's content model. If you use Jekyll, you explain Jekyll's. Every time.

seite's agent understands your project natively. It knows the configuration format, the collection types, your existing content, and the template system. The system prompt is generated from your actual seite.toml and content directory, not a generic "you are a helpful assistant" preamble. This means the agent produces files that build on the first try, use your existing tag taxonomy, and follow your site's established patterns.

Claude Code Scaffolding

When you run seite init, it creates .claude/settings.json with pre-configured permissions and a CLAUDE.md with site-specific instructions for the agent. This means Claude Code immediately understands your site's structure and conventions.

Next Steps