Lazy LLMs — AI skill for Claude Code

LLM-Native Project Management System

A project management system designed for LLM agents as first-class citizens. Track issues, log work, and manage projects with rich context - all optimized for AI workflows.

🚀 Quick Start (2 minutes)

One-Command Setup

make quickstart

This will:

1. Install all dependencies
2. Initialize the database
3. Start the web UI at http://localhost:1929
4. Copy Claude Desktop integration command to clipboard

Manual Setup

# 1. Install dependencies
pip install -r requirements.txt
cd mcp && pip install -r requirements.txt && cd ..

# 2. Initialize database
make init-db

# 3. Start services
make start  # Starts all services

🎯 Core Features

• Rich Issue Tracking - Issues with comprehensive specs and technical approaches
• Work Logging - Track development activity with artifacts and context
• Git Integration - Automatic branch creation and commit formatting
• Web UI - Visual dashboards and issue management at http://localhost:1929
• MCP Tools - 23 tools for LLM agents to manage projects

📋 Basic Usage

Create an Issue

pm_create_issue --type feature --title "Add user auth" --description "..."

Start Work

pm_start_work --issue-key LAZY-001

Log Progress

pm_log_work --issue-key LAZY-001 --activity code --summary "Implemented JWT"

View Status

pm_status  # Project overview
pm_list_issues  # All issues

🔧 Claude Desktop Integration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

{
  "mcpServers": {
    "pm-server": {
      "command": "python",
      "args": ["/path/to/lazy-llms/mcp/src/server.py"],
      "env": {
        "PM_DATABASE_PATH": "/path/to/lazy-llms/data/jira_lite.db"
      }
    }
  }
}

📂 Project Structure

lazy-llms/
├── mcp/src/              # MCP server for LLM integration
├── src/jira_lite/        # Web UI and database
├── data/                 # Da