Skip to main content
On this page

Kater CLI Projects and timelines project

kater project set

Change a project's name, goal, dates, summary or tags, 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.

Examples

Terminal window
# Change a project's name, goal, dates, summary or tags, in one commit
kater project set <project> --why <why>

Arguments

ArgumentDescription
<project>The project’s id.

Options

OptionDescription
--title <title>The project’s title, as the page shows it, such as Paid Social conversion. The project’s name and folder follow the title.
--goal <goal>One sentence that says what the project is for.
--starts <starts>When the project starts, such as 2026-10-05; none takes it off.
--ends <ends>When the project ends, such as 2026-11-30; none takes it off.
--summary-from <summary-from>The app whose snapshots write the project’s summary, by its id. It must be one of the project’s apps.
--tags <tag>The project’s tags: key=value or a bare key, repeatable. They replace the tags it has. Write none to take them all off. You can give it more than one time.
--why <why>Required. Why you change it, which the timeline shows on its settings row.

It also takes the global options --json and --help.

See also