Analytics local-first para suas sessões do OpenCode

• Local-first

  O bind padrão é loopback. A aplicação não abre socket de saída e não envia telemetria. Seu histórico de sessões nunca sai da máquina que o produziu.

  OPENCODEVIEW_HOST=127.0.0.1

• Fonte somente leitura

  O banco do OpenCode é aberto em modo somente leitura no nível do engine e fixado com o pragma query_only. O OpencodeView é estruturalmente incapaz de escrever nele.

  readonly: true · PRAGMA query_only = 1

• Cache separado

  Toda métrica derivada vai para um arquivo SQLite próprio. O caminho do cache é verificado para nunca ser o mesmo arquivo, symlink ou hardlink da fonte.

  .cache/analytics.sqlite

• Redigir antes de sair

  Payloads de transcrição e ao vivo passam por redação server-side antes de o JSON deixar o processo: chaves com cara de segredo, tokens bearer, prefixos de provedores, userinfo de URL e caminhos absolutos do home.

  sk-… ghp-… → [REDACTED]

• Falha fechada

  Fazer bind fora do loopback sem token de autenticação não gera aviso — o servidor se recusa a iniciar. Exposição é sempre decisão deliberada do operador.

  sem token + bind público → exit

01Visão geral02Ao vivo03Consumo04Eficiência05Orquestração06Qualidade07Ferramentas

Para onde o orçamento realmente foi

Consolidações globais e por projeto: total de tokens, número de sessões, tempo ativo, chamadas de ferramenta e sessões sinalizadas. O volume de tokens por projeto é clicável — cada barra é um drill-down na tabela de sessões daquele projeto.

• Consolidação por projeto com tokens, sessões, tempo ativo e precisão de patch
• Distribuição de sinalizações em todo o corpus, ordenada por contagem
• Drill-down por projeto em uma tabela de sessões ordenável
• Contagem de subagentes exibida ao lado das sessões primárias

API

• /api/global
• /api/projects
• /api/projects/:id

Previews sintéticos de documentação — não são dados reais de usuário.

• Loop de falha de ferramenta

  tool_failure_loop
  Regra tool_calls ≥ 20 e taxa de erro > 30%

  O agente insistiu em chamar ferramentas que continuaram falhando. Normalmente uma suposição errada sobre o ambiente.

• Desperdício de patch

  patch_waste
  Regra patch_count > 50, apply_patch_ok = 0, summary_additions = 0

  Mais de cinquenta tentativas de patch, nada aplicado, nada adicionado. Queima pura.

• Pressão de contexto

  context_pressure
  Regra compaction_count > 15

  A sessão gastou mais esforço compactando contexto do que avançando.

• Truncamento

  truncation
  Regra ao menos uma mensagem com finish = length

  A saída bateu no teto de tokens. O que vinha depois nunca foi escrito.

• Bug de metadados

  omo_metadata_bug
  Regra título da sessão começa com o literal 'undefined'

  Um defeito de metadados do harness vazou para o título armazenado.

• Anomalia de segurança

  security_anomaly
  Regra título casa com heurísticas locais de string tipo injeção

  Vale um olhar humano. Só casamento de string — sem modelo, sem rede.

• Baixo retorno, alto custo

  low_yield_high_cost
  Regra > 1M tokens, sem adições, sem apply_patch bem-sucedido

  Um milhão de tokens gastos sem nada aterrissar no diff.

• Lacuna de qualidade de dados

  data_quality_gap
  Regra mês da sessão cai em uma janela conhecida de baixa cobertura

  Não é problema da sessão — é problema do dataset. Sinalizado para nunca ser lido como zero real.

• OpenCode

  Obrigatório

  O runtime dos agentes e o histórico de sessões

  O OpenCode é dono do runtime dos agentes e do banco em disco que o OpencodeView lê. A evolução do schema pertence a eles, então o adaptador SQLite daqui é best-effort e pode ficar atrás de migrações upstream. Quando o dado de origem parece errado, é lá que se investiga — as sinalizações deste lado são heurísticas locais do operador, não afirmações sobre o OpenCode.

  opencode.ai ↗ anomalyco/opencode ↗

• oh-my-openagent

  Opcional

  Harness opcional que enriquece a lente Ao vivo

  Um harness de agentes para o OpenCode, também chamado de omo. Quando o log de atividade dele está legível, o servidor sobrepõe telemetria de polling por sessão na lente Ao vivo: o estado de saúde suspeita e eventos terminais como poll_timeout, max_turns, aborted_by_user e terminal_error. A sinalização omo_metadata_bug também nasce aí. Todo o resto funciona sem ele.

  code-yeongyu/oh-my-openagent ↗ omo.dev ↗

Ambos são projetos de terceiros. O OpencodeView não tem vínculo, endosso ou manutenção compartilhada com nenhum dos dois.

• Bind

  Padrão 127.0.0.1, aceitando também localhost e ::1. Guardas de Host e Origin se aplicam no loopback.

• Autenticação

  Qualquer host fora do loopback exige OPENCODEVIEW_AUTH_TOKEN. Sem ele o processo encerra em vez de subir desprotegido.

• Redação

  Chaves com cara de segredo, tokens bearer, prefixos comuns de provedores, userinfo de URL e caminhos absolutos do home são substituídos antes da serialização.

• Cache HTTP

  Respostas da API vão com Cache-Control: no-store. Nada analítico fica em intermediário.

• Telemetria

  Não existe. O runtime não abre nenhuma conexão de analytics de produto para fora.

• Cadeia de suprimentos

  O Gitleaks roda como gate obrigatório no bun run check, junto de testes, typecheck, lint, build e auditoria de dependências.

Expor além do loopback é escolha do operador. Revise as regras de redação contra os seus próprios dados antes de fazer isso.

1. 01

   Clone e instale

   O workspace web instala em separado — é uma aplicação Vite distinta.

   Copiar

   git clone https://github.com/4i3n6/opencodeview.git
   cd opencodeview
   bun install
   cd web && bun install && cd ..

2. 02

   Materialize o cache

   Lê a fonte em somente leitura e escreve as consolidações no próprio arquivo SQLite. Aponte OPENCODE_DB para outro lugar se sua instalação não for padrão.

   Copiar

   bun src/scan.ts --all
   
   # ou um projeto só
   bun src/scan.ts --list
   bun src/scan.ts <projeto>

3. 03

   Sirva o dashboard

   API e UI rodam como dois processos, ambos presos ao loopback.

   Copiar

   bun run serve   # http://127.0.0.1:4317
   bun run web     # http://127.0.0.1:5273