Skene MCP Server

   

O Skene lê sua base de código e produz uma jornada do usuário para o seu produto: os estágios do ciclo de vida pelos quais um usuário passa, os marcos dentro de cada estágio e as evidências de código ou banco de dados que comprovam que cada marco é real.

Início Rápido

Instale e inicie a interface de terminal interativa:

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

O assistente orienta você na seleção do provedor, autenticação e análise — sem necessidade de configuração prévia.

O Que Ele Faz

O Skene transforma um repositório em um único journey.yaml descrevendo o ciclo de vida do usuário do seu produto e o renderiza como um diagrama interativo.

• Análise agentiva — dois agentes paralelos leem seu projeto: um percorre a base de código, outro percorre seus esquemas SQL. Cada um propõe marcos candidatos, que são então mesclados e classificados em um ciclo de vida canônico de sete estágios.
• Jornada do usuário em sete estágios — todo produto é mapeado para os mesmos estágios canônicos (descoberta, integração, ativação, engajamento, retenção, expansão, viralidade), para que as jornadas sejam comparáveis entre produtos. Os nomes dos estágios são especializados para o seu produto quando útil.
• Marcos baseados em evidências — cada marco carrega um tracked_event, uma pontuação de confidence e um ou mais selos de evidence apontando de volta para o caminho exato do código, tabela do banco de dados ou arquivo de configuração que o justifica.
• Visualizador de jornada — a TUI abre um aplicativo web local que organiza os estágios como colunas, com cartões de marcos e selos de evidência clicáveis, para que você possa revisar a jornada junto com o código-fonte subjacente.
• Apenas código, apenas esquema ou ambos — execute apenas contra uma base de código, apenas um diretório de arquivos *.sql ou ambos para evidências mais ricas.

Suporta OpenAI, Gemini, Claude, LM Studio, Ollama e qualquer endpoint compatível com OpenAI.

Instalação

Interface de Terminal (recomendado)

A TUI é um assistente interativo que guia você por todo o fluxo de trabalho. Sem pré-requisitos — o instalador cuida de tudo.

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

# Launch it
skene

CLI Python

Se preferir a linha de comando, você pode executar o Skene diretamente com uvx (sem necessidade de instalação) ou instalá-lo globalmente:

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

# Run directly (no install needed)
uvx skene analyse-journey .

# Or install globally
pip install skene
skene analyse-journey .

Flags úteis:

• --schema-dir <dir> — aponta para um diretório de arquivos *.sql exportados para habilitar o agente de esquema
• -o <path> — sobrescreve o arquivo de saída (padrão ./skene-context/journey.yaml)
• --no-specialize — mantém os nomes de estágio canônicos em vez de deixar o LLM especializá-los

Para uso completo da CLI, veja a documentação.

Layout de Saída

Tanto a CLI Python quanto a TUI gravam artefatos em um único diretório de pacote na raiz do seu projeto, criado automaticamente se não existir.

• Padrão: ./skene-context/journey.yaml — a jornada do usuário analisada para o seu produto.
• Sobrescrita: defina output_dir em .skene.config ou passe -o/--output para gravar em outro local.

Estrutura do Monorepo

Diretório	Descrição	Linguagem	Distribuição
src/skene/	CLI + motor de análise	Python	PyPI
tui/	Assistente de interface de terminal interativa	Go	GitHub Releases
cursor-plugin/	Plugin para Cursor IDE	—	—
skills/	Skene Skills — esquemas de backend componíveis para Supabase	SQL	npm

A TUI (tui/) é um aplicativo Bubble Tea que fornece uma experiência de assistente interativo e orquestra a CLI Python via uvx. Cada pacote possui pipelines de CI/CD independentes.

Contribuindo

Contribuições são bem-vindas. Por favor, abra uma issue ou envie um pull request.

Licença

MIT