Kater CLI › Projects and timelines › project › metric
kater project metric set
Change one metric of a project, in one commit.
Show the change to the person and make it only after they say yes. What you leave out stays as it is.
# Change one metric of a project, in one commit
kater project metric set <project> <name> --why <why>
| Argument | Description |
|---|
<project> | The project’s id. |
<name> | The metric’s name in the project, such as tiktok_roas. kater project show lists them. |
| Option | Description |
|---|
--label <text> | The metric as people read it, such as TikTok ROAS. |
--better <better> | Which way is good: higher, lower, or none for a number that should only stay in its range. |
--alert <alert> | When to say so: below:2.2, above:5000, change:20 (a percent), or none for outside its normal range. |
--reach <target-value> | The target: the value to reach and by when, such as 2.5:2026-11-30, or none to take it off. |
--goal | Make it the goal’s metric. The metric that was the goal stops being it. |
--why <why> | Required. Why you change it, which the timeline shows on its settings row. |
It also takes the global options --json and --help.