Olly Molly is a local-first AI development team manager. Assign tasks to AI agents (PM, Frontend, Backend, QA) and watch them work on your codebase—all from a beautiful kanban board interface.

Quick Start

npx olly-molly

That's it. Open http://localhost:1234 and start managing your AI team.

Features

• 🎯 Kanban Board — Drag-and-drop task management
• 🤖 AI Agents — PM, Frontend Dev, Backend Dev, QA agents
• 💬 Natural Requests — Ask PM in plain language, get structured tickets
• 🔒 Local-First — Everything runs on your machine
• 🎨 Minimal Design — Clean, paper-like UI inspired by fontshare.com
• 🌙 Dark Mode — Easy on the eyes

How It Works

┌─────────────────────────────────────────────────────────┐
│                      Olly Molly                         │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  You ──▶ PM Agent ──▶ Creates Tickets                  │
│              │                                          │
│              ▼                                          │
│  ┌─────────────────────────────────────────────────┐   │
│  │  TODO  │  PROGRESS  │  REVIEW  │  DONE  │ HOLD  │   │
│  │   📋   │     🔄     │    👀    │   ✅   │  ⏸️   │   │
│  └─────────────────────────────────────────────────┘   │
│              │                                          │
│              ▼                                          │
│  Agents (FE/BE/QA) work on assigned tickets            │
│              │                                          │
│              ▼                                          │
│  Code changes in YOUR local project                    │
│                                                         │
└─────────────────────────────────────────────────────────┘

Setup

Prerequisites

• Node.js 18+
• One of the following CLI tools: Codex CLI, OpenCode, or Claude CLI

Run with npx (Recommended)

npx olly-molly

On macOS (arm64/x64) and Windows x64, npx olly-molly will use prebuilt bundles from GitHub Releases when available. Asset naming:

olly-molly-darwin-arm64.tar.gz
olly-molly-darwin-x64.tar.gz
olly-molly-win32-x64.tar.gz

Or install globally

npm install -g olly-molly
olly-molly

Development

git clone https://github.com/ruucm/olly-molly.git
cd olly-molly
npm install
npm run dev

AI CLI Tools (Required for Agent Execution)

To run AI agents, you need to install Codex CLI, OpenCode, or Claude CLI:

macOS (via Homebrew):

# OpenCode
brew install sst/tap/opencode

# Codex CLI
npm install -g @openai/codex

# Claude CLI
brew install anthropics/tap/claude-code

Windows:

# OpenCode (via npm)
npm install -g opencode-ai

# Codex CLI (via npm)
npm install -g @openai/codex

# Claude CLI (via npm)
npm install -g @anthropic-ai/claude-code

Note: Windows npm packages may not be officially supported. If installation fails, consider using WSL (Windows Subsystem for Linux) with Homebrew.

Project Selection

1. Click "Select Project" in the header
2. Add your project path (e.g., /Users/you/my-app)
3. AI agents will work within that directory

Contributing

We love contributions! Here's how you can help:

Ways to Contribute

• 🐛 Bug Reports — Found a bug? Open an issue
• 💡 Feature Requests — Have an idea? Let's discuss
• 🔧 Pull Requests — Code contributions are welcome
• 📖 Documentation — Help improve our docs
• 🎨 Design — UI/UX improvements

Development Setup

# Clone the repo
git clone https://github.com/ruucm/olly-molly.git
cd olly-molly

# Install dependencies
npm install

# Start development server
npm run dev

# Open http://localhost:1234

Releasing a New Version

scripts/build-prebuilt-macos.sh

npm version major|minor|patch
npm publish

git push origin main

gh release create v0.2.21 \
  dist/prebuilt/olly-molly-darwin-arm64.tar.gz \

for windows:

powershell -ExecutionPolicy Bypass -File scripts/build-prebuilt-windows.ps1

gh release upload v0.2.21 dist/prebuilt/olly-molly-win32-x64.tar.gz --clobber

Project Structure

olly-molly/
├── app/                 # Next.js app router
│   ├── api/            # API routes
│   ├── design-system/  # Design system docs
│   └── page.tsx        # Main dashboard
├── components/         # React components
│   ├── kanban/        # Kanban board
│   ├── ui/            # Reusable UI components
│   └── ...
├── db/                 # SQLite schemas
└── lib/               # Utilities

Code Style

• TypeScript for type safety
• Functional components with hooks
• CSS variables for theming
• Minimal dependencies

Tech Stack

• Framework: Next.js 16
• UI: React 19, Tailwind CSS 4
• Database: TanStack DB (@tanstack/react-db) with IndexedDB persistence
• Drag & Drop: dnd-kit
• AI: Codex CLI / OpenCode / Claude CLI

License

MIT © ruucm