archgate doctor

Verifica o ambiente do sistema, o método de instalação e as integrações com editores. Útil para diagnosticar problemas de configuração e compartilhar contexto de depuração em relatórios de bugs.

archgate doctor [options]

Opções

Opção	Descrição
--json	Saída legível por máquina

Seções da saída

• System — SO, arquitetura, detecção de WSL, versões do Bun e Node
• Archgate — Versão da CLI, método de instalação (binary, proto, local, global-pm), diretório de configuração, status de telemetria e login, o tipo de sessão armazenada (platform, legacy ou none) e o estado da entrada de git credential helper que o archgate login grava para o host de plugins
• Project — Se existe um projeto .archgate/, contagem de ADRs, domínios
• Editor CLIs — Se claude, cursor, code (VS Code), copilot e git estão disponíveis no PATH
• Project Integrations — Se os arquivos de plugin específicos de cada editor existem no projeto atual (.claude/settings.local.json, .vscode/settings.json, .github/copilot/instructions.md); para o Cursor, se a CLI cursor está disponível, já que o plugin do Cursor é incorporado em uma extensão VSIX em vez de um arquivo do projeto

A linha Git helper mostra OK quando a entrada aponta para o binário archgate em execução e nenhum outro helper é consultado antes dela. MISSING significa que há uma sessão da plataforma armazenada, mas a entrada não existe; STALE significa que ela aponta para outro binário archgate, normalmente após uma atualização ou reinstalação; SHARED significa que outro helper é consultado antes dela; NO SESSION significa que a entrada existe, mas não há nada armazenado para ela servir; not registered significa que não há entrada nem sessão da plataforma para servir, que é o estado esperado após archgate login logout. Todos os estados, exceto OK e not registered quando desconectado, vêm seguidos do comando que os corrige, e um token legado recebe uma indicação para archgate login refresh, já que o helper não consegue servi-lo. Um git clone de plugin que pede senha geralmente se deve a um desses casos.

Exemplo

archgate doctor

System
  OS:           win32/x64
  Bun:          1.3.11
  Node:         v24.3.0

Archgate
  Version:      0.25.1
  Install:      binary
  Exec path:    /home/user/.archgate/bin/archgate
  Config dir:   /home/user/.archgate OK
  Telemetry:    enabled
  Logged in:    yes
  Session:      platform
  Git helper:   OK (credential.https://plugins.archgate.dev.helper)

Project
  ADRs:         5 (3 with rules)
  Domains:      ARCH, GEN

Editor CLIs
  claude:       OK
  cursor:       MISSING
  code (vscode):OK
  copilot:      MISSING
  git:          OK

Project Integrations
  Claude:       OK (.claude/settings.local.json)
  Cursor:       MISSING (VSIX extension with embedded plugin)
  VS Code:      OK (.vscode/settings.json)
  Copilot:      MISSING (.github/copilot/instructions.md)