# 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:
```bash
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:
```javascript
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:
```javascript
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:
```javascript
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](https://repomix.com)) usa o Repomix como biblioteca para processar repositórios remotos. Você pode ver a implementação em [website/server/src/remoteRepo.ts](https://github.com/yamadashy/repomix/blob/main/website/server/src/remoteRepo.ts).