Skip to content
Fjord
5 min read

fj issue

Work with issues

fj issue [OPTIONS] <COMMAND>

Every command also accepts the global flags: --host, --debug, --no-pager, --json-fields.

Options

  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue list

List issues in a repo

fj issue list [OPTIONS]

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -s, --state <STATE> — Filter by state [default: open][possible values: open, closed, all]
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • -L, --limit <LIMIT> — Maximum number of issues to fetch (default 30; results may be capped unless –paginate) [default: 30]
  • --paginate — Fetch all pages instead of stopping at –limit
  • --page <PAGE> — Page of results to fetch [default: 1]
  • -l, --label <LABEL> — Filter by label
  • -a, --assignee <ASSIGNEE> — Filter by assignee
  • --milestone <MILESTONE> — Filter by milestone name or id
  • --mentioned <MENTIONED> — Filter by mentioned user login
  • -S, --search <QUERY> — Search text to filter by
  • --json — Emit JSON instead of a table
  • --web — Open the issue list in your browser

fj issue view

View an issue by number

fj issue view [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --comments — Include the comment thread
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • --json — Emit JSON instead of a table
  • --web — Open the issue in your browser

fj issue create

Create an issue with optional labels and assignees

fj issue create [OPTIONS]

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -t, --title <TITLE> — Issue title
  • -b, --body <BODY> — Body. Use - to read from stdin. Omit to open $EDITOR
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • -F, --body-file <FILE> — Read body from file (use - for stdin)
  • --template — [<NAME>] Preload the issue body from a repository issue template
  • -l, --label <NAME> — Label name to add. Repeat or use commas for multiple labels
  • -a, --assignee <USERNAME> — Username to assign. Repeat or use commas for multiple assignees
  • --web — Open the new issue in your browser after creating

fj issue edit

Edit an issue’s title/body or add/remove labels and assignees

fj issue edit [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -t, --title <TITLE> — Issue title
  • -b, --body <BODY> — New body. Use - to read from stdin. Pass --body-editor to open $EDITOR
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • -F, --body-file <FILE> — Read body from file (use - for stdin)
  • --body-editor — Open $EDITOR to edit the body inline (overrides --body)
  • --add-label <NAME> — Label name to add. Repeat or use commas for multiple labels
  • --remove-label <NAME> — Label name to remove. Repeat or use commas for multiple labels
  • --add-assignee <USERNAME> — Username to assign. Repeat or use commas for multiple assignees
  • --remove-assignee <USERNAME> — Username to unassign. Repeat or use commas for multiple assignees

fj issue close

Close an issue

fj issue close [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue reopen

Reopen a closed issue

fj issue reopen [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue lock

Lock an issue conversation

fj issue lock [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --reason <REASON> — Reason for locking the conversation [possible values: off-topic, too-heated, resolved, spam]
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue unlock

Unlock an issue conversation

fj issue unlock [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue delete

Delete an issue permanently (requires repo admin)

fj issue delete [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -y, --yes — Skip the confirmation prompt
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue pin

Pin an issue to the top of the issue list

fj issue pin [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue unpin

Unpin a pinned issue

fj issue unpin [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue comment

Add a comment

fj issue comment [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -b, --body <BODY> — Comment body. Use - to read from stdin. Omit to open $EDITOR
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • -F, --body-file <FILE> — Read body from file (use - for stdin)

fj issue edit-comment

Edit a comment by id (comment ids come from issue view --comments)

fj issue edit-comment [OPTIONS] <COMMENT_ID>

Arguments

  • <COMMENT_ID> — Comment id (NOT the issue number). Find it via issue view --comments --json

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -b, --body <BODY> — New body. Use - to read from stdin. Omit to open $EDITOR
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • -F, --body-file <FILE> — Read body from file (use - for stdin)

fj issue delete-comment

Delete a comment by id

fj issue delete-comment [OPTIONS] <COMMENT_ID>

Arguments

  • <COMMENT_ID> — Comment id

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -y, --yes — Skip the confirmation prompt
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]

fj issue develop

Create a branch tied to the issue

fj issue develop [OPTIONS] <NUMBER>

Arguments

  • <NUMBER> — Issue number

Options

  • -R, --repo <REPO> — Target repository as <owner>/<name>. Inferred from the git remote when omitted
  • -n, --name <NAME> — Branch name. Defaults to issue-<number>-<slug-of-title>
  • --base <BASE> — Base branch to start from. Defaults to the repo’s default branch
  • --color <COLOR> — When to use ANSI color in output [default: auto][possible values: auto, always, never]
  • --dry-run — Just print the branch name; don’t run git

Related articles

Core Repositories, branches, tags, issues, pull requests, releases, and search.fj CLI A native command-line tool for Forgejo and Gitea-compatible forges.branch-create Create a branch on Forgejo.branch-delete Delete a branch on Forgejo.browse Open the current repo (or a path within it) in your browser.pr Work with pull requests.
Edit this page

Last updated:

Contributors
  • Stephen Way

A Raster & State project. See fjord.sh for status, support, and legal policies.

© 2026 Raster & State LLC. All rights reserved.