Command

`okulo authors`

Unify developer identities and suggest aliases for .okulo.toml.

identitysetup

When to use it

Before trusting ownership or bus factor — the same person often appears under multiple emails/names.

Usage

okulo authors [repo] [options]

Options

Option	Default	Description
`-w, --window`	12m	Activity window shown in the table
`-f, --format`	table	`table` or `json`

Examples

Review identities and suggestions

okulo authors
okulo authors -f json | jq '.suggestions'

Then confirm in config

# .okulo.toml
[authors.aliases]
"Ada Lovelace" = ["ada@example.com", "alovelace"]

Sample output

Illustrative terminal output (column layout matches the real CLI):

Authors  identities merged by shared name/email
author           commits  last commit  status  emails  also known as
───────────────  ───────  ───────────  ──────  ──────  ─────────────────────
Ada Lovelace         412  2026-10-08   active       2  ada@acme.io, alovelace
Grace Hopper         301  2026-09-12   active       1
Old Contractor        44  2025-11-02   gone         2  oc@vendors.io

Suggested aliases (add to .okulo.toml if correct):
  "Ada Lovelace" = ["ada.lovelace@users.noreply.github.com"]

How to read it

also known as / emails — identities Okulo already merged. Confirm they are the same human.
gone — no commits inside --inactive-after. Important for ownership “gone %” and bus factor.
Apply Suggested aliases in config before trusting social reports; suggestions never auto-apply.

Tips

Commit alias fixes so CI and teammates share the same social metrics.

okulo authors