Skene is a codebase analysis toolkit for product-led growth. It models your product's user journey from your schema and code, surfaces growth opportunities, and turns them into actionable implementation plans.

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.

• Journey-first analysis -- compiles a view of your product's user journey: lifecycle stages, milestones, and value points, derived from your schema and code
• Journey visualizer -- opens the compiled journey in a local web app, with the lifecycle stages and milestones laid out as a diagram alongside the underlying data
• 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 -- when an engine.yaml is present, build writes supabase/migrations/*_skene_triggers.sql; push sends whatever bundle files exist to upstream
• Loop validation -- verifies that growth loop requirements are implemented (Python, JavaScript, TypeScript)

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

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

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.

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-context/ — holds schema.yaml, engine.yaml, growth-manifest.json, growth-template.json, growth-plan.md, feature-registry.json, and related assets.
• Upgrading from v0.3.x: delete any existing ./skene/ or ./skene-context/ directories before re-running, so the new analysis starts from a clean slate.
• Override: set output_dir in .skene.config or pass -o/--output to a specific command to write elsewhere.

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.

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

MIT