Kronk CLI

Build static sites faster with AI. Framework detection, quality guardrails, and seamless integration with your favorite AI coding tools.

What It Does

Kronk solves the problem of AI tools not understanding your static site generator. When you run kronk init, it:

1. Detects your framework (Hugo, Jekyll, Astro, Eleventy, etc.)
2. Generates guardrail files with framework-specific rules
3. Sets up quality checks for SEO, accessibility, performance, and security
4. Configures your project for AI-assisted development

The generated guardrails are automatically loaded by AI coding tools, ensuring every interaction follows your framework's conventions.

Installation

npm install -g kronk-cms

Requires Node.js 18 or later.

Quick Start

cd my-hugo-blog
kronk init

That's it. Your AI tool now understands your project.

Commands

| Command | Description | |---------|-------------| | kronk init | Initialize project with framework detection and guardrails | | kronk new [name] | Create a new static site project | | kronk detect | Show detected framework and configuration | | kronk audit | Run quality audit (SEO, accessibility, performance) | | kronk context | Export project context to clipboard for AI tools | | kronk status | Show project overview | | kronk migrate <platform> | Migrate from WordPress to static site | | kronk theme [description] | Generate theme with AI assistance | | kronk content [prompt] | Create content with guardrails | | kronk addon list | Browse available themes and plugins | | kronk addon install [name] | Install a theme or plugin | | kronk doctor | Check system requirements |

Supported Frameworks

| Framework | Config Detection | Content Directory | |-----------|-----------------|-------------------| | Hugo | hugo.toml, config.toml | content/ | | Jekyll | _config.yml | _posts/, _pages/ | | Astro | astro.config.mjs | src/content/ | | Eleventy | .eleventy.js, eleventy.config.js | configurable | | Gatsby | gatsby-config.js | src/pages/ | | Next.js | next.config.js | pages/, app/ | | Nuxt | nuxt.config.js | pages/, content/ | | Hexo | _config.yml | source/_posts/ | | VuePress | .vuepress/config.js | docs/ | | Docusaurus | docusaurus.config.js | docs/ |

AI Tool Integration

Kronk generates rules in the native format for each AI coding tool. Set up one or all:

kronk claude setup       # Claude Code skills (.claude/skills/)
kronk cursor setup       # Cursor rules (.cursor/rules/*.mdc)
kronk windsurf setup     # Windsurf rules (.windsurf/rules/*.md)
kronk antigravity setup  # Antigravity (GEMINI.md + AGENTS.md + workflows)
kronk codex setup        # OpenAI Codex (AGENTS.md)
kronk gemini setup       # Gemini Code Assist (GEMINI.md)
kronk ai setup           # Set up all tools at once

| Tool | Format | Files Generated | |------|--------|----------------| | Claude Code | Skills (SKILL.md) | .claude/skills/kronk-*/SKILL.md (13 skills) | | Cursor | MDC rules | .cursor/rules/kronk-*.mdc (4 rule files) | | Windsurf | Markdown rules | .windsurf/rules/kronk-*.md (3 rule files) | | Antigravity | GEMINI.md + AGENTS.md | GEMINI.md, AGENTS.md, .antigravity/workflows/ | | Codex | AGENTS.md | AGENTS.md (cross-tool format) | | Gemini | GEMINI.md | GEMINI.md (also used by Antigravity) |

Each tool's setup includes:

• Framework-specific template rules and conventions
• Content structure guidelines and front matter requirements
• Quality guardrails (SEO, accessibility, performance, security)
• Methodology skills with composition chains

Claude Code Skills

kronk claude setup installs 13 skills as Claude Code slash commands:

CMS Skills:

• /kronk - Project context and skill orchestration
• /kronk-content - Create content with guardrails
• /kronk-audit - Quality audit
• /kronk-theme - Theme generation and modification

Quality Guards:

• /kronk-code-quality - HTML/CSS/JS quality enforcement
• /kronk-seo - SEO enforcement (meta, OG, structured data)
• /kronk-theme-guard - Theme consistency enforcement
• /kronk-theme-create - Systematic theme creation (tokens first)
• /kronk-design-adapt - Copy/adapt designs from reference sites
• /kronk-writing-style - Match existing content voice/tone
• /kronk-images - Image optimization and responsive handling
• /kronk-usability - WCAG 2.1 AA compliance audit
• /kronk-verify - Mandatory verification gate

Composition Chains (skills auto-chain for quality enforcement):

• Content: content -> writing-style -> seo -> verify
• Theme: theme-create -> theme-guard -> code-quality -> verify
• Design: design-adapt -> theme-guard -> code-quality -> verify
• Images: images -> seo -> code-quality -> verify

Skills auto-update when the CLI version changes - no manual intervention needed.

Cross-Tool Format

AGENTS.md is a cross-tool format recognized by Antigravity, Codex, and Cursor. GEMINI.md is used by Gemini Code Assist and takes highest priority in Antigravity. Both Antigravity and Codex generate AGENTS.md, so they share the same project rules.

Quality Guardrails

Guardrails are enforced through generated rules and methodology skills:

SEO - Title 30-60 chars, meta description 120-160 chars, OG/Twitter tags, structured data, alt text Accessibility - WCAG 2.1 AA, keyboard navigation, color contrast 4.5:1, semantic HTML Performance - Image optimization, lazy loading, responsive srcset, minimal JS Security - Output escaping, HTTPS resources, input validation, rel="noopener"

Configure in .kronk/config.yaml:

guardrails:
  enforce: true
  seo: true
  accessibility: true
  performance: true
  security: true
  usability: true

Project Structure

After kronk init:

your-project/
├── CLAUDE.md              # AI guardrails (auto-generated)
├── .kronk/
│   └── config.yaml        # Kronk configuration
├── .claude/skills/kronk-* # Claude Code skills (if set up)
├── .cursor/rules/         # Cursor rules (if set up)
├── .windsurf/rules/       # Windsurf rules (if set up)
├── GEMINI.md              # Gemini/Antigravity rules (if set up)
├── AGENTS.md              # Cross-tool rules (if set up)
└── content/               # Your content directory

Configuration

.kronk/config.yaml:

ai:
  default: claude-code    # claude-code, cursor, windsurf, antigravity, codex, gemini

guardrails:
  enforce: true
  seo: true
  accessibility: true
  performance: true
  security: true
  usability: true

project:
  framework: auto         # auto-detect or specify
  contentDir: content/
  outputDir: public/

Examples

# Create a new Hugo blog
kronk new my-blog --framework hugo && cd my-blog && kronk init

# Set up Claude Code integration
kronk claude setup

# Audit content quality
kronk audit

# Generate theme with AI
kronk theme "minimal blog with dark mode and syntax highlighting"

# Export context for any AI tool
kronk context

# Migrate from WordPress
kronk migrate wordpress --from-url https://example.com --to hugo

Part of AIVory

Kronk is developed by AIVory, Inc. It integrates with other AIVory tools:

• AIVory Guard - Security scanning for AI-generated code
• AIVory Architect - Deployment and infrastructure management

Learn more at getkronk.com

Development

git clone https://github.com/aivorynet/kronk-cms.git
cd kronk-cms/cli
npm install
npm run build
npm link

License

MIT License. See LICENSE for details.

Links

• Website: getkronk.com
• Documentation: getkronk.com/docs
• Issues: github.com/aivorynet/kronk-cms/issues