Skip to content

thacio/auditaria

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11,994 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Auditaria

Version License


Captura de Tela do Auditaria

O Auditaria Γ© um fork especializado do Google Gemini CLI projetado especificamente para fluxos de trabalho de auditorias, engenharia de software e anΓ‘lise de dados. Este fork aprimora a ferramenta original com recursos focados em auditoria, suporte multi-idioma e capacidades de fluxo de trabalho melhoradas, mantendo todas as capacidades originais de engenharia de software intactas.

πŸš€ Por que Auditaria?

  • 🌐 Interface Web: Interface web integrada para interaΓ§Γ£o baseada em navegador
  • πŸ“ Editor AvanΓ§ado: Edite arquivos diretamente no navegador com um editor Monaco integrado e visualizadores de arquivo.
  • ✍️ Escrita Colaborativa: Edite arquivos simultaneamente com a IA. Ela vΓͺ suas alteraΓ§Γ΅es em tempo real, permitindo uma verdadeira programaΓ§Γ£o em par e co-escrita.
  • πŸ€– Agente de NavegaΓ§Γ£o: AutomaΓ§Γ£o de navegador com IA - a IA pode navegar na web, extrair dados, preencher formulΓ‘rios e executar tarefas complexas autonomamente
  • πŸ’¬ IntegraΓ§Γ΅es de Mensagens: Telegram, Discord e Microsoft Teams β€” converse com a IA direto nas suas plataformas de comunicaΓ§Γ£o
  • 🎯 NΓ­vel gratuito: 60 solicitaΓ§Γ΅es/min e 1.000 solicitaΓ§Γ΅es/dia com conta pessoal do Google
  • 🧠 Poderoso Gemini 2.5 Pro: Acesso a janela de contexto de 1M tokens
  • 🌐 Multi-idioma: Suporte completo para PortuguΓͺs e InglΓͺs com comando /language
  • πŸ“¦ ExecutΓ‘veis Windows: ExecutΓ‘veis standalone compilados com Bun (sem necessidade de instalaΓ§Γ£o de Node.js)
  • πŸ›‘οΈ CΓ³digo aberto: Licenciado sob Apache 2.0

πŸ“‹ Principais Recursos

Melhorias Exclusivas do Auditaria

  • 🌐 Interface Web: Uma interface web completa com um explorador de arquivos e abas para uma experiΓͺncia de usuΓ‘rio aprimorada.
  • πŸ“ Editor AvanΓ§ado: Um editor de cΓ³digo integrado (Monaco, o motor do VS Code) com visualizadores de arquivo integrados para PDFs, imagens, vΓ­deos e muito mais.
  • ✍️ Escrita Colaborativa: Ativa um fluxo de trabalho verdadeiramente colaborativo onde vocΓͺ e a IA podem modificar o mesmo arquivo simultaneamente. A IA estΓ‘ sempre ciente de suas ediΓ§Γ΅es, permitindo um trabalho de equipe interativo em cΓ³digo e documentos.
  • πŸ€– Agente de NavegaΓ§Γ£o (Browser Agent): AutomaΓ§Γ£o de navegador com IA usando Stagehand
    • Streaming ao vivo do navegador na interface web
    • Controle de execuΓ§Γ£o (pausar/continuar/parar)
    • Modo takeover: assuma controle manual do navegador durante a execuΓ§Γ£o
    • Capturas de telas
  • πŸ”„ Provedores de LLM Alternativos: Troque entre diferentes backends de IA em tempo de execuΓ§Γ£o usando o menu /model. Todas as ferramentas do Auditaria funcionam independente do provedor β€” gerenciamento de contexto, escrita colaborativa, busca de conhecimento, agente de navegaΓ§Γ£o e habilidades. Requer que as CLIs externas estejam instaladas e configuradas separadamente.
    • Claude Code: Use Claude (Opus, Sonnet, Haiku) como backend alternativo com o mesmo contexto, memΓ³ria e ferramentas customizadas
    • OpenAI Codex: Use modelos ChatGPT Codex como backend alternativo com as mesmas ferramentas e gerenciamento de contexto
    • GitHub Copilot: Use modelos do Copilot (Claude, Gemini, GPT e mais) com sua assinatura do GitHub Copilot
  • 🎯 Gerenciamento de Contexto: Ferramentas integradas para inspecionar, esquecer e restaurar conteΓΊdo da conversa para otimizar uso de tokens
    • context_inspect - Inspecionar histΓ³rico e estatΓ­sticas de tokens
    • context_forget - Esquecer conteΓΊdo grande (amnΓ©sia completa atΓ© restauraΓ§Γ£o)
    • context_restore - Restaurar conteΓΊdo esquecido quando necessΓ‘rio
  • πŸŽ“ Habilidades de Agente (Agent Skills): Sistema modular de habilidades que estende as capacidades do Auditaria com conhecimento especializado em domΓ­nios especΓ­ficos. Implementa o mesmo sistema de skills do Claude, sendo compatΓ­vel com skills do Claude
    • Descoberta automΓ‘tica de habilidades em .auditaria/skills/
    • CompatΓ­vel com skills criadas para Claude
    • Crie habilidades customizadas com arquivos SKILL.md
  • 🌐 Suporte Multi-idioma: InternacionalizaΓ§Γ£o completa com suporte para PortuguΓͺs e InglΓͺs (com comando /language)
  • πŸ” Busca de Conhecimento: O agente pode indexar e buscar em todos os documentos do projeto usando busca por palavra-chave (correspondΓͺncia exata), semΓ’ntica (entende significado) ou hΓ­brida (combina ambas para melhores resultados). Suporta PDFs, Office, imagens com OCR e mais. Use /knowledge-base init para iniciar.
  • πŸ’¬ IntegraΓ§Γ΅es com Plataformas de Mensagens: Interaja com o Auditaria atravΓ©s de plataformas de mensagens populares, mantendo sincronizaΓ§Γ£o bidirecional com a CLI
    • Telegram: Bot com streaming em tempo real, suporte a imagens e controle de acesso por usuΓ‘rio (/telegram start)
    • Discord: Bot com streaming em tempo real, suporte a imagens e comandos integrados (/discord start)
    • Microsoft Teams: IntegraΓ§Γ£o via Power Automate com sessΓ΅es isoladas por thread, modos de resposta plugΓ‘veis (sync/async/pull/hybrid) e tunelamento ngrok (/teams start)
  • 🎯 Recursos Focados em Auditoria: Prompts de sistema especializados e capacidades adaptadas para tarefas de auditoria
  • πŸ“Š Ferramentas de AnΓ‘lise de Dados: Capacidades aprimoradas para analisar e trabalhar com dados de auditoria

Recursos Herdados do Gemini CLI

  • CompreensΓ£o e GeraΓ§Γ£o de CΓ³digo
    • Consultar e editar grandes bases de cΓ³digo
    • Gerar novos aplicativos a partir de PDFs, imagens ou esboΓ§os usando capacidades multimodais
    • Depurar problemas e solucionar com linguagem natural
  • AutomaΓ§Γ£o e IntegraΓ§Γ£o
    • Automatizar tarefas operacionais como consultar pull requests ou lidar com rebases complexos
    • Usar servidores MCP para conectar novas capacidades
    • Executar de forma nΓ£o interativa em scripts para automaΓ§Γ£o de fluxo de trabalho
  • Capacidades AvanΓ§adas
    • Fundamentar consultas com Google Search integrado
    • Checkpointing de conversaΓ§Γ£o para salvar e retomar sessΓ΅es complexas
    • Arquivos de contexto personalizados (GEMINI.md) para adaptar o comportamento aos seus projetos

πŸ“¦ InstalaΓ§Γ£o

ExecutΓ‘veis Windows Standalone (Sem Node.js)

Download Direto

Baixe os executΓ‘veis Windows prΓ©-compilados da pΓ‘gina de releases:

  • auditaria-windows.exe - CLI executΓ‘vel standalone (~125MB)
  • auditaria-launcher.exe - Launcher com interface grΓ‘fica para selecionar diretΓ³rio de trabalho (~125MB)

⚠️ Aviso de SeguranΓ§a Corporativa: Os executΓ‘veis sΓ£o compilados usando Bun e nΓ£o sΓ£o assinados digitalmente. PolΓ­ticas corporativas de seguranΓ§a podem bloquear a execuΓ§Γ£o. VocΓͺ pode precisar:

  • Adicionar uma exceΓ§Γ£o no antivΓ­rus
  • Executar como administrador
  • Usar a instalaΓ§Γ£o via npm como alternativa

InstalaΓ§Γ£o RΓ‘pida com Node.js

Executar instantaneamente com npx

# Usando npx (sem instalaΓ§Γ£o necessΓ‘ria)
npx @thacio/auditaria

Instalar globalmente com npm

# Via npm
npm install -g @thacio/auditaria

# Ou clonar e construir
git clone https://github.com/thacio/auditaria
cd ./auditaria
npm run build
npm run bundle
npm install -g .

Requisitos do Sistema

  • Node.js versΓ£o 20 ou superior
  • macOS, Linux ou Windows

ConfiguraΓ§Γ£o de Firewall Corporativo (MITM)

⚠️ AVISO DE SEGURANΓ‡A: Desabilitar a verificaΓ§Γ£o SSL pode representar uma falha de seguranΓ§a. No entanto, em ambientes corporativos com firewall MITM, o npm recusarΓ‘ a instalaΓ§Γ£o porque o firewall substitui os certificados SSL originais por seus prΓ³prios certificados para inspecionar o trΓ‘fego. Isso faz com que o npm detecte um certificado "nΓ£o confiΓ‘vel" e bloqueie a instalaΓ§Γ£o. Use estas configuraΓ§Γ΅es apenas em redes corporativas confiΓ‘veis onde a TI controla a infraestrutura.

ConfiguraΓ§Γ£o do NPM para InstalaΓ§Γ£o

# Instalar o Auditaria com verificaΓ§Γ£o SSL desabilitada
npm install -g @thacio/auditaria --strict-ssl=false

ConfiguraΓ§Γ£o de ExecuΓ§Γ£o

Windows Command Prompt (cmd)
set NODE_TLS_REJECT_UNAUTHORIZED=0 && auditaria
Windows PowerShell
$env:NODE_TLS_REJECT_UNAUTHORIZED = "0"; auditaria
Linux/macOS
NODE_TLS_REJECT_UNAUTHORIZED=0 auditaria

πŸ” OpΓ§Γ΅es de AutenticaΓ§Γ£o

Escolha o mΓ©todo de autenticaΓ§Γ£o que melhor atende Γ s suas necessidades:

OpΓ§Γ£o 1: Login OAuth (Usando sua Conta Google)

✨ Melhor para: Desenvolvedores individuais e qualquer pessoa com licença Gemini Code Assist

BenefΓ­cios:

  • NΓ­vel gratuito: 60 solicitaΓ§Γ΅es/min e 1.000 solicitaΓ§Γ΅es/dia
  • Gemini 2.5 Pro com janela de contexto de 1M tokens
  • Sem gerenciamento de chave API - apenas faΓ§a login com sua conta Google
  • AtualizaΓ§Γ΅es automΓ‘ticas para os modelos mais recentes
auditaria
# Escolha OAuth e siga o fluxo de autenticaΓ§Γ£o do navegador

OpΓ§Γ£o 2: Chave da API Gemini

✨ Melhor para: Desenvolvedores que precisam de controle específico do modelo ou acesso pago

BenefΓ­cios:

  • NΓ­vel gratuito: 100 solicitaΓ§Γ΅es/dia com Gemini 2.5 Pro
  • SeleΓ§Γ£o de modelo: Escolha modelos Gemini especΓ­ficos
  • CobranΓ§a baseada em uso: Atualize para limites mais altos quando necessΓ‘rio
# Obtenha sua chave em https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
auditaria

OpΓ§Γ£o 3: Vertex AI

✨ Melhor para: Equipes empresariais e cargas de trabalho de produção

BenefΓ­cios:

  • Recursos empresariais: SeguranΓ§a e conformidade avanΓ§adas
  • EscalΓ‘vel: Limites de taxa mais altos com conta de cobranΓ§a
  • IntegraΓ§Γ£o: Funciona com infraestrutura existente do Google Cloud
# Obtenha sua chave do Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
auditaria

πŸš€ ComeΓ§ando

Uso BΓ‘sico

Iniciar no diretΓ³rio atual

auditaria

Incluir mΓΊltiplos diretΓ³rios

auditaria --include-directories ../lib,../docs

Usar modelo especΓ­fico

auditaria -m gemini-2.5-flash

Modo nΓ£o interativo para scripts

auditaria -p "Explique a arquitetura desta base de cΓ³digo"

Interface Web

A interface web fornece uma maneira alternativa de interagir com o Auditaria atravΓ©s do seu navegador:

  • Interface web habilitada por padrΓ£o: auditaria (abre automaticamente o navegador)
  • Desabilitar interface web: auditaria --no-web
  • Iniciar sem abrir navegador: auditaria --no-web-browser
  • Comando durante execuΓ§Γ£o: Use /web para abrir a interface web a qualquer momento
  • Porta padrΓ£o: 8629 (usa uma porta aleatΓ³ria se estiver ocupada)

Exemplos RΓ‘pidos

Iniciar um novo projeto

cd novo-projeto/
auditaria
> Escreva-me um bot Discord que responde perguntas usando um arquivo FAQ.md que fornecerei

Analisar cΓ³digo existente

git clone https://github.com/thacio/auditaria
cd auditaria
auditaria
> Me dΓͺ um resumo de todas as mudanΓ§as que entraram ontem

πŸ”— IntegraΓ§Γ£o com GitHub

Integre o Auditaria diretamente em seus fluxos de trabalho do GitHub com a Gemini CLI GitHub Action:

  • RevisΓ΅es de Pull Request: Revise automaticamente pull requests quando forem abertos
  • Triagem de Issues: Trie e rotule automaticamente issues do GitHub
  • ColaboraΓ§Γ£o sob demanda: Mencione @gemini-cli em issues e pull requests para assistΓͺncia
  • Fluxos de trabalho personalizados: Configure suas prΓ³prias tarefas agendadas e automaΓ§Γ΅es orientadas por eventos

πŸ“š DocumentaΓ§Γ£o

ComeΓ§ando

Recursos Principais

Ferramentas e ExtensΓ΅es

TΓ³picos AvanΓ§ados

SoluΓ§Γ£o de Problemas e Suporte

🀝 Contribuindo

Damos as boas-vindas a contribuiΓ§Γ΅es! O Auditaria Γ© totalmente open source (Apache 2.0), e encorajamos a comunidade a:

  • Relatar bugs e sugerir recursos
  • Melhorar a documentaΓ§Γ£o
  • Enviar melhorias de cΓ³digo
  • Compartilhar seus servidores MCP e extensΓ΅es

Veja nosso Guia de ContribuiΓ§Γ£o para configuraΓ§Γ£o de desenvolvimento, padrΓ΅es de codificaΓ§Γ£o e como enviar pull requests.

πŸ“– Recursos

Desinstalar

Veja o Guia de DesinstalaΓ§Γ£o para instruΓ§Γ΅es de remoΓ§Γ£o.

πŸ“„ Legal


Auditaria

Auditaria Screenshot

Auditaria is a specialized fork of the Google Gemini CLI designed specifically for audits, software engineering, and data analysis workflows. This fork enhances the original tool with audit-focused features, multi-language support, and improved workflow capabilities while maintaining all original software engineering capabilities intact.

πŸš€ Why Auditaria?

  • 🌐 Web Interface: Built-in web interface for browser-based interaction
  • πŸ“ Advanced Editor: Edit files directly in the browser with an integrated Monaco editor and file previewers.
  • ✍️ Collaborative Writing: Edit files simultaneously with the AI. It sees your changes as you make them, enabling true pair-programming and co-writing.
  • πŸ€– Browser Agent: AI-driven browser automation - the AI can browse the web, extract data, fill forms, and execute complex tasks autonomously
  • πŸ’¬ Messaging Integrations: Telegram, Discord, and Microsoft Teams β€” chat with the AI directly from your communication platforms
  • 🎯 Free tier: 60 requests/min and 1,000 requests/day with personal Google account.
  • 🧠 Powerful Gemini 3 models: Access to improved reasoning and 1M token context window.
  • 🌐 Multi-language: Full support for Portuguese and English with /language command
  • πŸ“¦ Windows Executables: Standalone executables compiled with Bun (no Node.js installation required)
  • πŸ›‘οΈ Open source: Apache 2.0 licensed.

πŸ“‹ Key Features

Auditaria Exclusive Enhancements

  • 🌐 Web Interface: A full-featured web UI with a file browser and tabs for an enhanced user experience.
  • πŸ“ Advanced Editor: An integrated code editor (Monaco, the engine that powers VS Code) with built-in file previewers for PDFs, images, videos, and more.
  • ✍️ Collaborative Writing: Enables a true collaborative workflow where you and the AI can modify the same file simultaneously. The AI is always aware of your edits, allowing for interactive teamwork on code and documents.
  • πŸ€– Browser Agent: AI-driven browser automation using Stagehand
    • Live browser streaming in the web interface
    • Execution control (pause/resume/stop)
    • Takeover mode: take manual control of the browser during execution
    • Take Screenshots
  • πŸ”„ Alternative LLM Providers: Switch between different AI backends at runtime using the /model menu. All Auditaria tools work regardless of provider β€” context management, collaborative writing, knowledge search, browser agent, and skills. Requires the external CLIs to be installed and configured separately.
    • Claude Code: Use Claude (Opus, Sonnet, Haiku) as an alternative backend with the same context, memory, and custom tools
    • OpenAI Codex: Use ChatGPT Codex models as an alternative backend with the same tools and context management
    • GitHub Copilot: Use Copilot models (Claude, Gemini, GPT, and more) with your GitHub Copilot subscription
  • 🎯 Context Management: Built-in tools to inspect, forget, and restore conversation content to optimize token usage
    • context_inspect - Inspect history and token statistics
    • context_forget - Forget large content (complete amnesia until restored)
    • context_restore - Restore forgotten content when needed
  • πŸŽ“ Agent Skills: Modular skills system that extends Auditaria's capabilities with specialized domain-specific knowledge. Implements the same skills system as Claude, making it compatible with Claude skills
    • Automatic skill discovery from .auditaria/skills/
    • Compatible with skills created for Claude Code
    • Create custom skills with SKILL.md files
  • 🌐 Multi-language Support: Full internationalization with Portuguese and English support (with /language command)
  • πŸ” Knowledge Search: The agent can index and search through all project documents using keyword (exact match), semantic (understands meaning), or hybrid search (combines both for best results). Supports PDFs, Office files, images with OCR, and more. Use /knowledge-base init to get started.
  • πŸ’¬ Messaging Platform Integrations: Interact with Auditaria through popular messaging platforms with bidirectional CLI sync
    • Telegram: Bot with real-time streaming, image support, and per-user access control (/telegram start)
    • Discord: Bot with real-time streaming, image support, and built-in commands (/discord start)
    • Microsoft Teams: Power Automate integration with per-thread isolated sessions, pluggable response modes (sync/async/pull/hybrid), and ngrok tunneling (/teams start)
  • 🎯 Audit-Focused Features: Specialized system prompts and capabilities tailored for audit tasks
  • πŸ“Š Data Analysis Tools: Enhanced capabilities for analyzing and working with audit data

Inherited from Gemini CLI

  • Code Understanding & Generation
    • Query and edit large codebases
    • Generate new apps from PDFs, images, or sketches using multimodal capabilities
    • Debug issues and troubleshoot with natural language
  • Automation & Integration
    • Automate operational tasks like querying pull requests or handling complex rebases
    • Use MCP servers to connect new capabilities
    • Run non-interactively in scripts for workflow automation
  • Advanced Capabilities
    • Ground your queries with built-in Google Search
    • Conversation checkpointing to save and resume complex sessions
    • Custom context files (GEMINI.md) to tailor behavior for your projects

πŸ“¦ Installation

See Auditaria CLI installation, execution, and releases for recommended system specifications and a detailed installation guide.

Windows Standalone Executables (No Node.js Required)

Direct Download

Download pre-compiled Windows executables from the releases page:

  • auditaria-windows.exe - Standalone CLI executable (~125MB)
  • auditaria-launcher.exe - GUI launcher to select working directory (~125MB)

⚠️ Corporate Security Warning: The executables are compiled using Bun and are not digitally signed. Corporate security policies may block execution. You may need to:

  • Add an antivirus exception
  • Run as administrator
  • Use npm installation as an alternative

Quick Install with Node.js

Run instantly with npx

# Using npx (no installation required)
npx @thacio/auditaria

Install globally with npm

# Via npm
npm install -g @thacio/auditaria

# Or clone and build
git clone https://github.com/thacio/auditaria
cd ./auditaria
npm run build
npm run bundle
npm install -g .

System Requirements

  • Node.js version 20 or higher
  • macOS, Linux, or Windows

Install globally with MacPorts (macOS)

sudo port install gemini-cli

Install with Anaconda (for restricted environments)

# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli

Release Cadence and Tags

See Releases for more details.

Preview

New preview releases will be published each week at UTC 23:59 on Tuesdays. These releases will not have been fully vetted and may contain regressions or other outstanding issues. Please help us test and install with preview tag.

npm install -g @thacio/auditaria@preview

Stable

  • New stable releases will be published each week at UTC 20:00 on Tuesdays, this will be the full promotion of last week's preview release + any bug fixes and validations. Use latest tag.
npm install -g @thacio/auditaria@latest

Nightly

  • New releases will be published each day at UTC 00:00. This will be all changes from the main branch as represented at time of release. It should be assumed there are pending validations and issues. Use nightly tag.
npm install -g @thacio/auditaria@nightly

Corporate Firewall (MITM) Setup

⚠️ SECURITY WARNING: Disabling SSL verification may represent a security flaw. However, in corporate environments with MITM firewalls, npm will refuse to install because the firewall replaces the original SSL certificates with its own certificates to inspect traffic. This causes npm to detect an "untrusted" certificate and block the installation. Use these settings only in trusted corporate networks where IT controls the infrastructure.

NPM Configuration for Installation

# Install Auditaria with SSL verification disabled
npm install -g @thacio/auditaria --strict-ssl=false

Runtime Configuration

Windows Command Prompt (cmd)
set NODE_TLS_REJECT_UNAUTHORIZED=0 && auditaria
Windows PowerShell
$env:NODE_TLS_REJECT_UNAUTHORIZED = "0"; auditaria
Linux/macOS
NODE_TLS_REJECT_UNAUTHORIZED=0 auditaria

πŸ” Authentication Options

Choose the authentication method that best fits your needs:

Option 1: Sign in with Google (OAuth login using your Google Account)

✨ Best for:

  • Individual developers.
  • Google AI Pro and AI Ultra subscribers.
  • Anyone who has a Gemini Code Assist license.

See quota limits and terms of service for details.

Benefits:

  • Free tier: 60 requests/min and 1,000 requests/day
  • Gemini 3 models with 1M token context window
  • No API key management - just sign in with your Google account
  • Automatic updates to our latest models

Start Auditaria, then choose Sign in with Google and follow the browser authentication flow when prompted

auditaria

If you are using a paid Code Assist License from your organization, remember to set the Google Cloud Project

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
auditaria

Option 2: Gemini API Key

✨ Best for: Developers who need specific model control or paid tier access

Benefits:

  • Free tier: 1000 requests/day with Gemini 3 (mix of flash and pro)
  • Model selection: Choose specific Gemini models
  • Usage-based billing: Upgrade for higher limits when needed
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
auditaria

Option 3: Vertex AI

✨ Best for: Enterprise teams and production workloads

Benefits:

  • Enterprise features: Advanced security and compliance
  • Scalable: Higher rate limits with billing account
  • Integration: Works with existing Google Cloud infrastructure
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
auditaria

πŸš€ Getting Started

Basic Usage

Start in current directory

auditaria

Include multiple directories

auditaria --include-directories ../lib,../docs

Use specific model

auditaria -m gemini-2.5-flash

Non-interactive mode for scripts

Get a simple text response:

auditaria -p "Explain the architecture of this codebase"

For more advanced scripting, including how to parse JSON and handle errors, use the --output-format json flag to get structured output:

auditaria -p "Explain the architecture of this codebase" --output-format json

For real-time event streaming (useful for monitoring long-running operations), use --output-format stream-json to get newline-delimited JSON events:

auditaria -p "Run tests and deploy" --output-format stream-json

Web Interface

The web interface provides an alternative way to interact with Auditaria through your browser:

  • Web interface enabled by default: auditaria (automatically opens browser)
  • Disable web interface: auditaria --no-web
  • Start without opening browser: auditaria --no-web-browser
  • Command during runtime: Use /web to open the web interface at any time
  • Default port: 8629 (uses a random port if occupied)

Quick Examples

Start a new project

cd new-project/
auditaria
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

Analyze existing code

git clone https://github.com/thacio/auditaria
cd auditaria
auditaria
> Give me a summary of all of the changes that went in yesterday

πŸ“š Documentation

Getting Started

Core Features

Tools & Extensions

Advanced Topics

Troubleshooting & Support

  • Troubleshooting Guide - Common issues and solutions.
  • FAQ - Frequently asked questions.
  • Use /bug command to report issues directly from the CLI.

Using MCP Servers

Configure MCP servers in ~/.gemini/settings.json to extend Auditaria with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

See the MCP Server Integration guide for setup instructions.

🀝 Contributing

We welcome contributions! Auditaria is fully open source (Apache 2.0), and we encourage the community to:

  • Report bugs and suggest features
  • Improve documentation
  • Submit code improvements
  • Share your MCP servers and extensions

See our Contributing Guide for development setup, coding standards, and how to submit pull requests.

πŸ“– Resources

Uninstall

See the Uninstall Guide for removal instructions.

πŸ“„ Legal

Star History Rank


About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 79.5%
  • JavaScript 18.4%
  • CSS 1.1%
  • Python 0.4%
  • HTML 0.4%
  • Shell 0.1%
  • Other 0.1%