Skip to main content

AI Website Agent - Simple Version

AI Website Agent - Simple Version

A straightforward AI agent for editing your website. No complexity, no overengineering, just works.

Quick Start (2 minutes)

# 1. Install
cd ai-agent-simple
npm install

# 2. Configure (add your API key)
cp .env.example .env
# Edit .env and add your Anthropic API key

# 3. Run
npm start

That’s it! You’re now chatting with your AI agent.

What It Does

  • 📝 Edit Files: Read, write, and update any file
  • 📁 Browse: List and explore directories
  • 🔧 Run Commands: Execute git, jekyll, and other safe commands
  • 💬 Natural Chat: Just tell it what you want in plain English

Usage Examples

Interactive Chat

npm start
# or
node ai-agent.js chat

> You: Update the title in my index.html to "My Awesome Site"
> Agent: I'll update the title in index.html for you...

One-off Commands

node ai-agent.js "List all markdown files"
node ai-agent.js "Create a new blog post about AI"
node ai-agent.js "Commit all changes with message 'Updated content'"

What This Version Includes

✅ Single file implementation (~200 lines) ✅ Works with any static site ✅ Git integration ✅ Jekyll support ✅ No database needed ✅ No complex setup ✅ No Docker/Kubernetes/Terraform nonsense

What You Actually Need to Know

Environment Variables

ANTHROPIC_API_KEY=sk-ant-...    # Required
SITE_PATH=/path/to/your/site    # Optional (defaults to current dir)

Available Commands

The agent can safely run:

  • git - version control
  • jekyll - site building
  • bundle - gem management
  • ls, pwd, cat - file exploration

File Operations

  • Read any file
  • Write/create files (with auto directory creation)
  • List directory contents

When You Need More

This simple version handles 90% of use cases. Only add complexity when you actually need:

  • Multiple users: Add authentication
  • High traffic: Add Redis for caching
  • API access: Use the full backend version
  • Web UI: Add the dashboard component

Troubleshooting

“Missing API key”: Add your key to .env “Command not allowed”: Only safe commands are whitelisted “File not found”: Check your SITE_PATH setting

Deploy (When Ready)

Simplest: Run on Your Machine

npm install -g pm2
pm2 start ai-agent.js

Simple Cloud: Railway (One Click)

railway init
railway up

Still Simple: Any VPS

scp -r ai-agent-simple/ your-server:/app/
ssh your-server
cd /app && npm install && pm2 start ai-agent.js

That’s It!

No 50-page documentation. No complex architecture. Just a working AI agent for your website.

Problems? The code is only 200 lines - you can read and modify it yourself!

Sometimes simple is better.