Phoenix CLI

Invocação

px <resource> <action>                          # if installed globally
npx @arizeai/phoenix-cli <resource> <action>    # no install required

A CLI usa comandos de recurso singular com subcomandos como list e get:

px trace list
px trace get <trace-id>
px trace annotate <trace-id>
px trace add-note <trace-id>
px trace-annotations delete
px span list
px span annotate <span-id>
px span add-note <span-id>
px span-annotations delete
px session list
px session get <session-id>
px session annotate <session-id>
px session add-note <session-id>
px session-annotations delete
px dataset list
px dataset get <name>
px project list
px project get <name>
px annotation-config list
px auth status
px profile list
px profile show [name]
px profile create <name>
px profile use <name>
px profile edit <name>
px profile delete <name>

Configuração

export PHOENIX_HOST=http://localhost:6006
export PHOENIX_PROJECT=my-project
export PHOENIX_API_KEY=your-api-key  # if auth is enabled

Sempre use --format raw --no-progress ao enviar para jq.

Referência Rápida

Ambos os estágios marcam cada artefato com um identificador de anotação de codificação compartilhado (forma descritiva, por exemplo, coding-run:chatbot-context-loss-2026-05-06) para que a execução seja consultável, reversível e visualizável como uma unidade. Passe --identifier <value> explicitamente em cada chamada px — o herança do shell é não confiável entre os harnesses do agente. A codificação aberta escreve notas via px ... add-note e registra um pequeno arquivo JSONL local em .px/coding/<sanitized-identifier>.jsonl; a codificação axial lê esse arquivo como a entrega determinística e registra rótulos em .px/coding/<sanitized-identifier>-axial.jsonl. Escolha o identificador uma vez por execução (veja references/open-coding.md), depois compartilhe o link da UI do Phoenix da seção de resumo. A reversão é opcional e executa três exclusões vinculadas ao identificador somente após confirmação explícita do usuário.

Termo do fluxo de trabalho vs. nome da anotação do servidor. A prosa da habilidade chama esse valor de identificador de anotação de codificação (dica de variável de shell: CODING_ANNOTATION_IDENTIFIER). O NOME da anotação do lado do servidor usado para o filtro da UI permanece inalterado — coding_session_id — para compatibilidade de dados com linhas já escritas por execuções anteriores. Não tente renomear a anotação do lado do servidor; trate a assimetria como um ponto de carga.

Fluxos de Trabalho

"O que faço depois de instrumentar?" / "Onde devo focar?" / "O que está dando errado?" open-coding → axial-coding → construir avaliações para as categorias principais.

Categorias de Referência

Autenticação

px auth status                                # check connection and authentication
px auth status --endpoint http://other:6006   # check a specific endpoint
px auth status --profile staging              # check a named profile's connection

Perfis

Perfis nomeados permitem alternar entre várias instâncias do Phoenix (local, staging, nuvem) sem ter que gerenciar variáveis de ambiente. Os perfis são armazenados em ~/.px/settings.json (ou $XDG_CONFIG_HOME/px/settings.json).

Prioridade de configuração (mais alta para mais baixa): flags da CLI > variáveis de ambiente > perfil ativo > padrões integrados.

px profile list                              # listar todos os perfis (mostra o perfil ativo)
px profile show                              # mostrar as configurações do perfil ativo

…