Phoenix GitHub

Reference for managing issues, labels, and project boards on the

Arize-ai/phoenix

gh

Repository

Arize-ai/phoenix

Quick Reference

Label Taxonomy

Component Labels (

c/

)

Every issue should have at least one component label.

c/ui

c/server

c/traces

c/evals

c/datasets

c/experiments

c/annotations

c/prompts

c/playground

c/agents

c/client

c/rbac

c/auth

c/infra

c/mcp

c/filters

c/metrics

c/dx

Priority Labels

priority: highest

priority: high

priority: medium

priority: low

Type / Status Labels

roadmap

bug

enhancement

documentation

triage

blocked

backlog

needs information

design

onboarding

phoenix-cloud

Roadmap Issues

Roadmap issues are high-level epics representing product initiatives.

Title Format

🗺️ [category] Title

Categories:

ui/ux

agents

infrastructure

datasets/experiments

tracing

enterprise

server-evals

annotations

evals

prompts

sdk/connectors

Labels per Category

ui/ux

roadmap

priority: highest

c/ui

agents

roadmap

priority: highest

c/agents

infrastructure

roadmap

priority: highest

c/infra

datasets/experiments

roadmap

priority: highest

c/datasets

c/experiments

tracing

roadmap

priority: highest

c/traces

enterprise

roadmap

priority: highest

c/rbac

c/auth

server-evals

roadmap

priority: highest

c/evals

c/server

annotations

roadmap

priority: highest

c/annotations

evals

roadmap

priority: highest

c/evals

evals

roadmap

priority: highest

c/evals

c/playground

prompts

roadmap

priority: highest

c/prompts

c/playground

sdk/connectors

roadmap

priority: highest

c/client

Body Template

<one-line description of the initiative>

## Spike

- [ ]

## Front End

- [ ]

## Back End

- [ ]

## Open Questions

-

Creating a Roadmap Issue

gh issue create \
  --repo Arize-ai/phoenix \
  --title "🗺️ [category] Title" \
  --label "roadmap,priority: highest,c/ui" \
  --body "$(cat <<'EOF'
Description of the initiative.

## Spike

- [ ]

## Front End

- [ ]

## Back End

- [ ]

## Open Questions

-
EOF
)"

Project Board

Phoenix Roadmap (Project #45)

The canonical roadmap board for open-source Phoenix.

PVT_kwDOA5FfSM4AJaRo

PVTF_lADOA5FfSM4AJaRozgInoCI

PVTF_lADOA5FfSM4AJaRozgInn58

PVTSSF_lADOA5FfSM4AJaRozgFw9n0

Status option IDs:

f75ad846

47fc9ee4

98236657

Add an Issue to the Project

# 1. Get the issue node ID
NODE_ID=$(gh api repos/Arize-ai/phoenix/issues/{number} --jq '.node_id')

# 2. Add to project, capture item ID
ITEM_ID=$(gh api graphql -f query='
  mutation($project: ID!, $content: ID!) {
    addProjectV2ItemById(input: {projectId: $project, contentId: $content}) {
      item { id }
    }
  }' \
  -f project="PVT_kwDOA5FfSM4AJaRo" \
  -f content="$NODE_ID" \
  --jq '.data.addProjectV2ItemById.item.id')

Set Start / Target Date

gh api graphql -f query='
  mutation($project: ID!, $item: ID!, $field: ID!, $value: Date!) {
    updateProjectV2ItemFieldValue(input: {
      projectId: $project, itemId: $item, fieldId: $field,
      value: {date: $value}
    }) { projectV2Item { id } }
  }' \
  -f project="PVT_kwDOA5FfSM4AJaRo" \
  -f item="$ITEM_ID" \
  -f field="PVTF_lADOA5FfSM4AJaRozgInoCI" \  # Start Date field
  -f value="2026-04-01"

Set Status

gh api graphql -f query='
  mutation($project: ID!, $item: ID!, $field: ID!, $option: String!) {
    updateProjectV2ItemFieldValue(input: {
      projectId: $project, itemId: $item, fieldId: $field,
      value: {singleSelectOptionId: $option}
    }) { projectV2Item { id } }
  }' \
  -f project="PVT_kwDOA5FfSM4AJaRo" \
  -f item="$ITEM_ID" \
  -f field="PVTSSF_lADOA5FfSM4AJaRozgFw9n0" \
  -f option="47fc9ee4"   # In Progress

Remove an Issue from a Project

Requires the project item ID (not the issue number). Paginate if the project has many items:

gh api graphql -f query='
  mutation($project: ID!, $item: ID!) {
    deleteProjectV2Item(input: {projectId: $project, itemId: $item}) {
      deletedItemId
    }
  }' \
  -f project="PVT_kwDOA5FfSM4AJaRo" \
  -f item="$ITEM_ID"

Note:

gh issue create

does not support

--json

. Capture the issue URL from stdout and extract the number with

grep -oE '[0-9]+$'

.

Standard Issues

Bug Report

gh issue create \
  --repo Arize-ai/phoenix \
  --title "Short description of the bug" \
  --label "bug,triage,c/traces" \
  --body "..."

Feature Request

gh issue create \
  --repo Arize-ai/phoenix \
  --title "Short description of the feature" \
  --label "enhancement,c/ui" \
  --body "..."

Existing Roadmap Issues (Q2 2026)

Issues #11618–#11666 on the Phoenix roadmap project (Start: 2026-02-20, Target: 2026-08-31):