forgejo-contrib/forgejo-cli

Watch20

Star402

Fork

You've already forked forgejo-cli

51

CodeIssues 44Pull requests 8Releases 11Packages 2WikiActivity

Add fj milestone subcommand (list, view, create, edit, delete) #357

New issue

Closed

opened 2026-03-15 02:43:45 +01:00 by philkhn · 0 comments

philkhn commented 2026-03-15 02:43:45 +01:00

Copy link

Problem

There is currently no way to manage milestones from the CLI. While milestones are visible in the web UI and accessible via the API, fj has no milestone subcommand.

Proposed solution

Add a fj milestone subcommand with full CRUD support:

fj milestone list

List milestones for the current repository:

• Title, state (open/closed), progress (open vs closed issues), due date
• --state open|closed|all filter (default: open)

fj milestone view <name>

View details of a specific milestone by title.

fj milestone create <title>

Create a new milestone:

• --description / -d (opens editor if flag given without value)
• --due-date / -D (RFC3339 format)

fj milestone edit <name>

Edit an existing milestone:

• --rename / -n — change title
• --description / -d — change description
• --due-date / -D — change due date
• --state / -s — set to open or closed

fj milestone delete <name>

Delete a milestone by title.

Context

• Related to #355 which proposes milestone + project support broadly — this issue focuses on the standalone milestone subcommand.
• The Forgejo API endpoints (GET/POST/PATCH/DELETE /repos/{owner}/{repo}/milestones) already provide all needed functionality.
• The forgejo_api crate (v0.9.2) exposes these endpoints.
• Milestone identification is by title (resolved to ID internally via the list endpoint).

Problem There is currently no way to manage milestones from the CLI. While milestones are visible in the web UI and accessible via the API, fj has no milestone subcommand. ## Proposed solution Add a fj milestone subcommand with full CRUD support: ### fj milestone list List milestones for the current repository: - Title, state (open/closed), progress (open vs closed issues), due date - --state open|closed|all filter (default: open) ### fj milestone view \<name\> View details of a specific milestone by title. ### fj milestone create \<title\> Create a new milestone: - --description / -d (opens editor if flag given without value) - --due-date / -D (RFC3339 format) ### fj milestone edit \<name\> Edit an existing milestone: - --rename / -n — change title - --description / -d — change description - --due-date / -D — change due date - --state / -s — set to open or closed ### fj milestone delete \<name\> Delete a milestone by title. ## Context - Related to #355 which proposes milestone + project support broadly — this issue focuses on the standalone milestone subcommand. - The Forgejo API endpoints (GET/POST/PATCH/DELETE /repos/{owner}/{repo}/milestones) already provide all needed functionality. - The forgejo_api crate (v0.9.2) exposes these endpoints. - Milestone identification is by title (resolved to ID internally via the list endpoint).

philkhn changed title from ** Add fj milestone list command to view milestones from the CLI ** to Add fj milestone subcommand (list, view, create, edit, delete) 2026-03-15 02:55:07 +01:00

philkhn referenced this issue from a pull request that will close it, 2026-03-15 03:10:03 +01:00 Add milestone subcommand (list, view, create, edit, delete) #359

Cyborus closed this issue 2026-03-15 14:37:51 +01:00

stalecontext referenced this issue from stalecontext/forgejo-cli-plus 2026-03-15 16:47:02 +01:00 Milestone support: subcommand, create/search/view integration #7

stalecontext referenced this issue from stalecontext/forgejo-cli-plus 2026-03-15 16:47:21 +01:00 feat: milestone support #8

stalecontext referenced this issue from a commit 2026-03-15 17:24:37 +01:00 feat: milestone support (#8)

Sign in to join this conversation.

No Branch/Tag specified

BranchesTags

main

renovate/lock-file-maintenance

renovate/serde-saphyr-0.x

docs/contributing

no-port-in-refspec

login/v16.next.forgejo.org

crates-io-publish

0.5.x

compile-time-fluent

0.4.x

localization-alias-demo

api_url_field

v0.5.0

v0.4.1

v0.4.0

v0.3.0

v0.2.0

v0.1.1

v0.1.0

v0.0.4

v0.0.3

v0.0.2

v0.0.1

Labels

Clear labels[ Kind/Breaking Breaking change that won't be backward compatible

](#)[ Kind/Bug Something is not working

](#)[ Kind/Design Discussion about UI/UX design

](#)[ Kind/Documentation Documentation changes

](#)[ Kind/Enhancement Improve existing functionality

](#)[ Kind/Feature New functionality

](#)[ Kind/Security This is security issue

](#)[ Kind/Testing Issue or pull request related to testing

](#)[ Kind/Upstream This is an issue with upstream software (Forgejo) that is probably not our fault

](#)

[ Priority

Critical The priority is critical

](#)[ Priority

High The priority is high

](#)[ Priority

Low The priority is low

](#)[ Priority

Medium The priority is medium

](#)

[ Reviewed

Confirmed Issue has been confirmed

](#)[ Reviewed

Duplicate This issue or pull request already exists

](#)[ Reviewed

Invalid Invalid issue

](#)[ Reviewed

Won't Fix This issue won't be fixed

](#)

[ Status

Abandoned Somebody has started to work on this but abandoned work

](#)[ Status

Blocked Something is blocking this issue or pull request

](#)[ Status

Need More Info Feedback is required to reproduce issue or to continue work

](#)

[ Suspicious

](#)

No labels Kind/Breaking Kind/Bug Kind/Design Kind/Documentation Kind/Enhancement Kind/Feature Kind/Security Kind/Testing Kind/Upstream [ Priority

Critical ](/forgejo-contrib/forgejo-cli/issues?labels=173012) [ Priority

High ](/forgejo-contrib/forgejo-cli/issues?labels=173013) [ Priority

Low ](/forgejo-contrib/forgejo-cli/issues?labels=173015) [ Priority

Medium ](/forgejo-contrib/forgejo-cli/issues?labels=173014) [ Reviewed

Confirmed ](/forgejo-contrib/forgejo-cli/issues?labels=173007) [ Reviewed

Duplicate ](/forgejo-contrib/forgejo-cli/issues?labels=173005) [ Reviewed

Invalid ](/forgejo-contrib/forgejo-cli/issues?labels=173006) [ Reviewed

Won't Fix ](/forgejo-contrib/forgejo-cli/issues?labels=173008) [ Status

Abandoned ](/forgejo-contrib/forgejo-cli/issues?labels=173011) [ Status

Blocked ](/forgejo-contrib/forgejo-cli/issues?labels=173010) [ Status

Need More Info ](/forgejo-contrib/forgejo-cli/issues?labels=173009) Suspicious

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

forgejo-contrib/forgejo-cli#357

WritePreview

Loading…

Add table

| Rows | | | Columns | |

CancelOK

Add a link

Url Description Hint: With a URL in your clipboard, you can paste directly into the editor to create a link.

CancelOK

CancelSave

Reference in a new issue

Repository

forgejo-contrib/forgejo-cli

Title

Body

Create issue

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

No Yes