Skip to content

ph insights ​

Flow and AI numbers of the organization, same as the Portal Projects pages: ph insights [flow|ai|health|report] [--project key] [--days N] [--json]

This page is generated from ph insights --help by npm run gen in site/, so do not edit it by hand.

text
Usage: ph insights [flow|ai|health|report] [--project <key>] [--days <n>] [--from YYYY-MM-DD --to YYYY-MM-DD] [--json]
text
       ph insights flow --compare --project <key> [--weeks <n>] [--json]
text
       ph insights releases --project <key> [--limit <n>] [--json]
text
       ph insights report --month YYYY-MM [--format pdf|csv|json] [--lang en|vi] [--project <key>] [--weeks <n>] [-o <file>]
text
  (none)   Overview: one row per project (velocity, flow time, flow efficiency, WIP, AI share of work, AI cost, at-risk tasks)

flow ​

text
flow     Flow Framework: velocity, flow time, flow efficiency, flow load (WIP), work type distribution, week by week

ai ​

text
ai       AI measurement: AI users, share of work with AI, harness use, AI cost, cost per done item, rework, with and without AI

health ​

text
health   Delivery health: tasks by status, first-pass approval, rework, at-risk tasks

releases ​

text
releases   Releases of a project: release wait time (from the moment the release was ready to the moment it was created) and AI cost per release, newest first. Per release, not per person. Needs --project

report ​

text
report   Monthly report to share (the same as Download in the Portal): AI cost per approved task, first-time approval, rework and flow time of the month, compared with the period before AI, with data quality notes. PDF is one A4 page; CSV is the weekly data; json prints the figures

--compare ​

text
--compare   With flow: the weeks before the project started using AI next to the same number of weeks after it. The start date is the first day Ryoma received telemetry for the project, or the date an owner or admin set (ph project adoption <key>). Warns when fewer than 10 tasks finished before. Needs --project

--limit ​

text
--limit   With releases: how many of the newest releases to show, 1 to 100 (default 20)

--weeks ​

text
--weeks   Length of each period for --compare and report, 1 to 26 (default 8)

--month ​

text
--month   Month of the report as YYYY-MM; the current month is partial (up to today)

--format ​

text
--format   Report format: pdf (default), csv or json

--lang ​

text
--lang    Language of the PDF report: en (default) or vi (labels, the "In short" summary and data notes; numbers are the same). Not used by csv and json

-o/--output ​

text
-o/--output   Where to save the report (default: the file name Tara suggests, in the current folder; "-" prints to the terminal)

--days ​

text
--days   Last N days (default 30, up to 364); reports are grouped by week (Monday), so the range is rounded to whole weeks

--from/--to ​

text
--from/--to   Custom range (dates, both included; --to defaults to today)

--project ​

text
--project   One project of the organization (default: all; required by --compare; without it a report covers every project)

--json ​

text
--json   Print the API response as JSON
text
Every role of the organization can use it. These are the numbers shown on the Projects pages of the Portal; no per-person numbers.