Projects

The projects command (alias p) manages Redmine projects.

list List all projects.

get View a single project, optionally with related data.

create Create a new project.

update Update fields, trackers, modules, and defaults.

archive Archive a project (Redmine 5.0+).

unarchive Restore an archived project (Redmine 5.0+).

delete Permanently remove a project.

members List members and their roles.

list

redmine projects list [flags]

Flag	Description
`--include`	Extra data, repeatable or comma-separated: `trackers`, `issue_categories`, `enabled_modules`, `time_entry_activities`, `issue_custom_fields`
`--limit`	Maximum number of results
`--offset`	Result offset for pagination
`-o, --output`	Output format: `table`, `json`, `csv`

The table view always shows ID, Identifier, Name, Status, Public. Use --output json to inspect any extra sections you requested with --include.

get

redmine projects get <identifier> [flags]

Aliases: show, view.

Flag	Description
`--include`	Extra data, repeatable or comma-separated: `trackers`, `issue_categories`, `enabled_modules`, `time_entry_activities`, `issue_custom_fields`
`-o, --output`	Output format

The detail view surfaces homepage, default assignee, default version, enabled modules, and project custom field values whenever they are present on the response.

create

redmine projects create [flags]

Flag	Description
`--name`	Project name — required
`--identifier`	URL-friendly identifier — required
`--description`	Project description
`--homepage`	Project homepage URL
`--public`	Make the project public
`--parent`	Parent project identifier, name, or numeric ID
`--inherit-members`	Inherit members from the parent project
`--default-assignee`	Default assignee for new issues (login, name, or numeric ID)
`--tracker`	Tracker name or ID to enable (repeatable or comma-separated)
`--enable-module`	Module to enable: `boards`, `calendar`, `documents`, `files`, `gantt`, `issue_tracking`, `news`, `repository`, `time_tracking`, `wiki`
`--issue-custom-field`	Issue-level custom field name or ID to enable (repeatable)
`--custom-field`	Project custom field value as `name=value` or `id=value` (repeatable)

redmine projects create \
  --name "Platform" --identifier platform \
  --homepage https://platform.example.test \
  --tracker Bug,Feature \
  --enable-module issue_tracking,wiki,time_tracking

update

redmine projects update <identifier> [flags]

Every flag is optional; omitted flags leave the corresponding field untouched.

Flag	Description
`--name`	New project name
`--description`	New description
`--homepage`	New homepage URL
`--public`	Set public visibility
`--parent`	New parent (identifier, name, or numeric ID). Pass empty to detach from the current parent.
`--inherit-members`	Toggle inheriting members from the parent project
`--default-assignee`	Default assignee (login, name, or numeric ID). Pass empty to attempt to clear (some Redmine versions ignore the clear).
`--default-version`	Default version (name or numeric ID). Pass empty to attempt to clear (some Redmine versions ignore the clear).
`--tracker`	Replace the enabled tracker set
`--enable-module`	Replace the enabled module set
`--issue-custom-field`	Replace the issue-level custom field set
`--custom-field`	Project custom field value as `name=value` or `id=value` (repeatable)

unarchive

Redmine 5.0+

redmine projects unarchive <identifier>

Restore a previously archived project so it appears in default listings again.

delete

destructive

redmine projects delete <identifier> [flags]

Flag	Description
`-f, --force`	Skip confirmation prompt

members

redmine projects members <identifier> [flags]

Lists all members and their roles for a project.