Skip to main content

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

Project description

Website Docs Blog Reddit

skene-growth

PyPI version Downloads Commit Activity

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.1.tar.gz (291.5 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.1-py3-none-any.whl (147.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: skene_growth-0.2.1.tar.gz
  • Upload date:
  • Size: 291.5 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.1.tar.gz
Algorithm Hash digest
SHA256 fd4f6d0f90363ca6b8efa3e0c412238b435c2ef3a7529025c0d6705d60dd3862
MD5 3ec6107098150046d5cb8901fb88bc36
BLAKE2b-256 362c6b58798863910203f8c09b32fb2717411a129904e74fe9fe65f450047183

See more details on using hashes here.

Provenance

The following attestation bundles were made for skene_growth-0.2.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: skene_growth-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 147.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for skene_growth-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9fa45fbc05153a56b6dd4ef159b3e751a49cc54b29bfa4c5f49205bb01041d6c
MD5 49a27d59ffca77c7bdcf39a0c0471fe7
BLAKE2b-256 a2c5c3749c737ac4be630df62ef1603a5406e5c03831d674ab3a2d01dc8947eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for skene_growth-0.2.1-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