skene 0.4.0rc4

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

   

Skene is a codebase analysis toolkit for product-led growth. It scan your codebase, detect growth opportunities, and generate actionable implementation plans.

Quick Start

Install and launch the interactive terminal UI:

curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene

The wizard walks you through provider selection, authentication, and analysis — no configuration needed upfront.

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 -- build writes supabase/migrations/*_skene_triggers.sql; push sends engine + that SQL 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

Terminal UI (recommended)

The TUI is an interactive wizard that guides you through the entire workflow. No prerequisites — the installer handles everything.

# Install the TUI
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash

# Launch it
skene

Python CLI

If you prefer the command line, you can run Skene directly with uvx (no install needed) or install it globally:

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

# Run directly (no install needed)
uvx skene

# Or install globally
pip install skene

For CLI usage details, see the documentation.

Output Layout

Both the Python CLI (including analyse-journey, analyze, plan, and build) and the interactive TUI write their artifacts to a single bundle directory in your project root. The directory is created automatically when it is missing.

• Default: ./skene/ — holds schema.yaml, engine.yaml, growth-manifest.json, growth-template.json, growth-plan.md, feature-registry.json, and related assets.
• Legacy: ./skene-context/ — the previous default. Existing projects continue to work: discovery commands (plan, build, push, features export, TUI detection) look for ./skene/ first and fall back to ./skene-context/ when only the legacy directory is present.
• Override: set output_dir in .skene.config or pass -o/--output to a specific command to write elsewhere.

Monorepo Structure

Directory	Description	Language	Distribution
src/skene/	CLI + analysis engine	Python	PyPI
tui/	Interactive terminal UI wizard	Go	GitHub Releases
cursor-plugin/	Cursor IDE plugin	—	—
skills/	Skene Skills -- composable backend schemas for Supabase	SQL	npm

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.

License

MIT