FJCTL(5) File Formats Manual FJCTL(5)

fjctl
fjctl configuration file

~/.config/fjctl/config.yaml

fjctl reads a YAML configuration file located at the above, XDG-compliant location.

The file is used primarily to specify the defaults and repositories keys, but can also be used for other options.

: Repository
Default settings to apply to all repositories
: string
Forgejo host to connect to
: string
Password for authentication
: string
Token for authentication when migrating repositories
: string
Username for authentication
: string
Template for repository clone address
: boolean
Migrate labels
: boolean
Migrate milestones
: Repository
Map of repositories by full name

An example that configures defaults and a single repository:
defaults:
  has_actions: true
  allow_merge_commits: false
  default_delete_branch_after_merge: true
  default_merge_style: fast-forward-only
  default_update_style: rebase

repositories:
  pbrisbin/hs-shellwords:
    description: Parse a string into a list of words, like a shell would
    has_releases: true
    allow_merge_commits: true

For the complete Repository schema, see the repository.schema.json file distributed with this software.

Directory where fjctl/config.yaml will be expected, usually ~/.config

fjctl(1)
October 14, 2025 Debian