skene

PLG (Product-Led Growth) codebase analysis toolkit. Scan your codebase, detect growth opportunities, and generate actionable implementation plans.

Quick Start

uvx skene config --init   # Create config file
uvx skene config          # Set provider, model, API key
uvx skene analyze .       # Analyze your codebase
uvx skene plan            # Generate a growth plan
uvx skene build           # Build an implementation prompt
uvx skene status          # Check loop implementation status
uvx skene push            # Deploy telemetry to Supabase + upstream

What It Does

• Tech stack detection -- identifies frameworks, databases, auth, deployment
• Growth feature discovery -- finds existing signup flows, sharing, invites, billing
• Feature registry -- tracks features across analysis runs, links them to growth loops
• Revenue leakage analysis -- spots missing monetization and weak pricing tiers
• Growth plan generation -- produces prioritized growth loops with implementation roadmaps
• Implementation prompts -- builds ready-to-use prompts for Cursor, Claude, or other AI tools
• Telemetry deployment -- generates Supabase migrations and pushes to upstream
• Loop validation -- verifies that growth loop requirements are implemented
• Interactive chat -- ask questions about your codebase in the terminal

Supports OpenAI, Gemini, Claude, LM Studio, Ollama, and any OpenAI-compatible endpoint. Free local audit available with no API key required.

Installation

# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Recommended (no install needed)
uvx skene

# Or install globally
pip install skene

Documentation

Full documentation: www.skene.ai/resources/docs/skene

MCP Server

skene includes an MCP server for integration with AI assistants. Add to your assistant config:

{
  "mcpServers": {
    "skene": {
      "command": "uvx",
      "args": ["--from", "skene[mcp]", "skene-mcp"],
      "env": {
        "SKENE_API_KEY": "your-api-key"
      }
    }
  }
}

Monorepo Structure

This repository contains two independent packages:

Directory	Description	Language	Distribution
src/skene/	CLI + analysis engine	Python	PyPI
tui/	Interactive terminal UI wizard	Go	GitHub Releases

The TUI (tui/) is a Bubble Tea app that provides an interactive wizard experience and orchestrates the Python CLI via uvx. Each package has independent CI/CD pipelines.

Contributing

Contributions are welcome. Please open an issue or submit a pull request on GitHub.

License

MIT