Hemingway

AI-powered copy editing overlay for marketing sites. Hemingway discovers text elements on your page and generates alternative copy using Claude, with one-click replacement.

Quick Start

1. Install

npm install hemingway-ai

2. Create a config

npx hemingway-ai init

This creates hemingway.config.mjs in your project root.

3. Set your API key

export ANTHROPIC_API_KEY=sk-ant-...

4. Start the server

npx hemingway-ai

5. Add the client to your site

Script tag (any framework):

<script src="http://localhost:4800/client.js"></script>

React component:

import { Hemingway } from 'hemingway-ai/react'

// Add inside your app (dev mode only)
<Hemingway />

6. Activate

Press Cmd/Ctrl+Shift+H (or your configured shortcut) on your dev site.

Config

/** @type {import('hemingway-ai').HemingwayConfig} */
const config = {
  port: 4800,
  model: 'claude-sonnet-4-6',
  styleGuide: './docs/style-guide.md',
  copyBible: './docs/copy-bible.md',
  sourcePatterns: [
    'components/**/*.tsx',
    'components/**/*.jsx',
    'src/**/*.tsx',
    'src/**/*.jsx',
    'app/**/*.tsx',
    'app/**/*.jsx',
    'pages/**/*.tsx',
    'pages/**/*.jsx',
  ],
  excludePatterns: ['node_modules', '.next', 'dist', 'build'],
  writeAdapter: 'react', // 'react' | 'generic'
  shortcut: 'ctrl+shift+h',
  accentColor: '#3b82f6',
};

export default config;

Features

• Click any text to get AI-generated copy alternatives
• Double-click for inline editing with source file writes
• Style guide aware — feed it your brand voice docs
• Framework agnostic — works with any dev server via script tag or React component
• Source mapping — writes changes back to your source files

Documentation

• Docs Home
• Quickstart
• Framework Setup Guides
• Configuration Reference
• API Reference
• Troubleshooting

Agent Reference Docs

Detailed, agent-oriented system docs live in:

• docs/reference/README.md
• docs/reference/architecture.md
• docs/reference/server-runtime.md
• docs/reference/browser-overlay.md
• docs/reference/copy-intelligence.md
• docs/reference/operations-and-packaging.md

Contributing

• Contributing Guide
• Code of Conduct
• Security Policy

License

MIT