Projects

The projects command (alias p) manages Redmine projects.

listList all projects.

getView a single project, optionally with related data.

createCreate a new project.

updateUpdate fields, trackers, modules, and defaults.

archiveArchive a project (Redmine 5.0+).

unarchiveRestore an archived project (Redmine 5.0+).

deletePermanently remove a project.

membersList 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)

Note

--tracker, --enable-module, and --issue-custom-field replace the current set when provided. Pass the full desired list, not just additions.

archive

Redmine 5.0+

redmine projects archive <identifier> [flags]

Flag	Description
-f, --force	Skip confirmation prompt

Archived projects are hidden from the default project listing and cannot be edited until they are unarchived.

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

Caution

Deleting a project removes all its issues, time entries, and memberships. There is no undo.

members

redmine projects members <identifier> [flags]

Lists all members and their roles for a project.