Skip to content

ph ryoma ​

My AI usage and reconciliation (usage, verify); administration: projects, alerts, report

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

text
Usage: ph ryoma [command]

Commands ​

usage ​

text
usage [--period day|week|month] [--json]
                                  My usage: converted cost, tokens, by project and by day (default: week and month)

verify ​

text
verify [--days <n>]               Reconcile Ryoma metrics with the Claude Code transcripts on this machine (default 7 days)

hook session-start ​

text
hook session-start                Use in the SessionStart hook (kit-ryoma-session): reports that a session just started

Every role of the organization (owner, admin, member, viewer) sees all its projects ​

projects ​

text
projects                          Projects I can see

report ​

text
report [--project <code>]         Project health and at-risk tasks; with --project also the data quality warnings (same as the Portal project page)

alerts ​

text
alerts                            Quotas and alerts for my projects

estimate ​

text
estimate <project> [--s N --m N --l N] [--issues GH-1,GH-2] [--weeks N]
                                  Sprint planning estimate: AI cost and time for a batch of tasks by S/M/L level, from the project's history
                                  (without a batch it prints the estimate basis); default 8 weeks

Administration (organization owner or admin) ​

projects (2) ​

text
projects [ls|contacts]            Projects (managed in Tara) and PM emails that receive alerts and the weekly digest (org owner or admin)

alerts (2) ​

text
alerts [set|remove]               Cost quotas (over-quota alert rules)

guardrails ​

text
guardrails [--days <n>]           Number of times Guardrails blocked, asked or masked, by project and rule (default 7 days)

guardrails audit ​

text
guardrails audit [--rule <id>] [--user <login>] [--days <n>]
                                  Detailed (masked) audit for Security; Ryoma must have RYOMA_GUARDRAILS_AUDIT turned on
text
Converted cost is the estimated API price calculated by Claude Code, used as the quota unit; it is not an amount you have to pay.
Ryoma address: PHILLIP_RYOMA_URL or ryomaUrl in the Phillip config. Authenticates with the Tara token of the current organization (ph tara login, ph org switch); data is per organization.