Skip to main content

PLG analysis toolkit for codebases - analyze code, detect growth opportunities, generate documentation

Project description

skene-growth

PyPI version Python License: MIT

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

Quick Start

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

What It Does

  • Tech stack detection -- identifies frameworks, databases, auth, deployment
  • Growth feature discovery -- finds existing signup flows, sharing, invites, billing
  • 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
  • Loop validation -- AST-based checks verify 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-growth

# Or install globally
pip install skene-growth

Documentation

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

MCP Server

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

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

Monorepo Structure

This repository contains two independent packages:

Directory Description Language Distribution
src/skene_growth/ 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skene_growth-0.2.1rc1.tar.gz (290.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skene_growth-0.2.1rc1-py3-none-any.whl (147.3 kB view details)

Uploaded Python 3

File details

Details for the file skene_growth-0.2.1rc1.tar.gz.

File metadata

  • Download URL: skene_growth-0.2.1rc1.tar.gz
  • Upload date:
  • Size: 290.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for skene_growth-0.2.1rc1.tar.gz
Algorithm Hash digest
SHA256 708f8f1fb8db4cbcca6f12473a3a807911a0077c8d9b998381193f69ce66bad3
MD5 9c9dc79cb2a7c391b8f20234446b2a8e
BLAKE2b-256 28373d5b1a9cfdcf8bff9602503777f093d0d24866e8d620d0a25bafdabb3bee

See more details on using hashes here.

Provenance

The following attestation bundles were made for skene_growth-0.2.1rc1.tar.gz:

Publisher: publish.yml on SkeneTechnologies/skene-growth

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file skene_growth-0.2.1rc1-py3-none-any.whl.

File metadata

File hashes

Hashes for skene_growth-0.2.1rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 6979ae3adc1bfbb78200e81f2cc065e6dc5207ac284fad70b46559f731e36a38
MD5 90896d155525f917e7a124a1ad9a761b
BLAKE2b-256 29a641af8da10605c7c28c8a14a75e33635d3616135d34e9284830ad38b77e14

See more details on using hashes here.

Provenance

The following attestation bundles were made for skene_growth-0.2.1rc1-py3-none-any.whl:

Publisher: publish.yml on SkeneTechnologies/skene-growth

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page