Usando Repomix como Biblioteca

Além de usar o Repomix como ferramenta CLI, você pode integrar suas funcionalidades diretamente em suas aplicações Node.js.

Instalação

Instale o Repomix como dependência em seu projeto:

npm install repomix

Uso Básico

A maneira mais simples de usar o Repomix é através da função runCli, que proporciona a mesma funcionalidade da interface de linha de comando:

import { runCli, type CliOptions } from 'repomix';

// Processar o diretório atual com opções personalizadas
async function packProject() {
  const options = {
    output: 'output.xml',
    style: 'xml',
    compress: true,
    quiet: true
  } as CliOptions;
  
  const result = await runCli(['.'], process.cwd(), options);
  return result.packResult;
}

O result.packResult contém informações sobre os arquivos processados, incluindo:

• totalFiles: Número de arquivos processados
• totalCharacters: Contagem total de caracteres
• totalTokens: Contagem total de tokens (útil para limites de contexto de LLM)
• fileCharCounts: Contagem de caracteres por arquivo
• fileTokenCounts: Contagem de tokens por arquivo

Processamento de Repositórios Remotos

Você pode clonar e processar um repositório remoto:

import { runCli, type CliOptions } from 'repomix';

// Clonar e processar um repositório GitHub
async function processRemoteRepo(repoUrl) {
  const options = {
    remote: repoUrl,
    output: 'output.xml',
    compress: true
  } as CliOptions;
  
  return await runCli(['.'], process.cwd(), options);
}

Usando Componentes Principais

Para maior controle, você pode usar as APIs de baixo nível do Repomix diretamente:

import { searchFiles, collectFiles, processFiles, TokenCounter } from 'repomix';

async function analyzeFiles(directory) {
  // Encontrar e coletar arquivos
  const { filePaths } = await searchFiles(directory, { /* configuração */ });
  const rawFiles = await collectFiles(filePaths, directory);
  const processedFiles = await processFiles(rawFiles, { /* configuração */ });
  
  // Contar tokens
  const tokenCounter = new TokenCounter('o200k_base');
  
  // Retornar resultados da análise
  return processedFiles.map(file => ({
    path: file.path,
    tokens: tokenCounter.countTokens(file.content)
  }));
}

Exemplo do Mundo Real

O site do Repomix (repomix.com) usa o Repomix como biblioteca para processar repositórios remotos. Você pode ver a implementação em website/server/src/remoteRepo.ts.