WDG AI Dev Environment

Appearance

Quick Start Guide ​

Get a WordPress site running with AI-powered development.

Quick Setup ​

bash
# 1. Clone and enter directory
git clone https://github.com/wdgdc/WDG-AI-Development-Environment.git && cd WDG-AI-Development-Environment

# 2. Run installer
./install.sh

# 3. Create your site (Wikit framework + theme + plugin)
wdg create my-site --init-wikit

# 4. Open in browser (the project starts automatically on create)
open https://my-site.localhost:6443

Port already in use?

If :6443 (or any other WDG port) conflicts with something on your machine, run wdg ports check to find conflicts and wdg ports find 5 6000 to discover free alternatives, then update them in .env.

You now have a fully functional WordPress site with AI code search capabilities.

What You've Set Up ​

Your installation includes:

  • ✅ WordPress with Wikit framework
  • ✅ MySQL database
  • ✅ Vector database for AI search
  • ✅ Custom theme from template
  • ✅ Project-level Claude Code skills and agents (synced from platform templates)
  • ✅ Local AI embeddings (no external API dependencies)

Essential Commands ​

Search Your Code with AI ​

bash
# Index your project for AI search
wdg my-site index

# List all indexed collections
wdg collections list

Manage Your Project ​

bash
# Check status
wdg status

# View logs
wdg my-site logs

# Stop the project
wdg my-site stop

# List all projects
wdg list

Connect Claude Code (and other MCP clients) ​

Projects created with --init-wikit are already wired to the MCP server, so Claude Code picks up the connection automatically inside the project directory. To register the WDG MCP server with Claude Code manually, point it at the Streamable HTTP endpoint:

bash
claude mcp add wdg-local --transport http http://localhost:6765/mcp

Claude can now search your codebase through the Model Context Protocol. The platform also proxies authenticated external services (Jira, Figma, Slack, Read.ai) — connect them with wdg mcp auth <service> and check status with wdg mcp status.

Troubleshooting ​

Check project status ​

bash
# See if your project is running
wdg status

# Start project if it's not running
wdg my-site start

Restart a project ​

bash
# If the project is running but having issues
wdg my-site restart

View logs ​

bash
# Check logs for errors
wdg my-site logs

# Follow logs in real-time
wdg my-site logs --follow

Reset database ​

bash
# Reset to fresh WordPress installation (keeps project)
wdg my-site db reset

Delete and recreate project ​

bash
# Complete project removal and recreation
wdg delete my-site --force
wdg create my-site --init-wikit

Run diagnostics ​

bash
# Check system health
wdg doctor

Next Steps ​

Continue Learning:

Advanced Topics:

You've successfully set up an AI-powered WordPress development environment with local code indexing.

Copyright © 2026 WDG