forge/config.example.toml at main · kenn-io/forge · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
sync_interval = "5m"
# Pause automatic sync after the current update. Default: false; persists across restarts.
# Relay updates, item visits, and manual Sync remain available on this Forge instance.
# A fleet spoke pauses local refresh only; its hub has a separate setting.
# Can also be changed in Settings > Sync. No restart required.
airplane_mode = false

# Raise the local hourly sync allowance for large or active repositories.
# Default: 500. Range: 50-15000. Zero uses the default. Applies without a
# restart, and is also adjustable under Settings > Sync.
# See docs/configuration.md#sync-budget for budget sharing and provider quota.
# sync_budget_per_hour = 3000

# Environment variable containing your GitHub personal access token.
# Required scopes: repo (private repos) or public_repo (public only).
github_token_env = "KENN_FORGE_GITHUB_TOKEN"

# Advanced: fine-grained PATs can be selected by exact GitHub owner. These
# entries are configured in TOML only; token_file is checked before token_env.
# [[github_owner_tokens]]
# owner = "my-organization"
# token_env = "KENN_FORGE_GITHUB_TOKEN_MY_ORGANIZATION"

# Host treated as implicit in repository UI labels
default_platform_host = "github.com"
host = "127.0.0.1"
port = 8091

# Style of branch name created for new issue workspaces. "slug" (default)
# appends a sanitized slug derived from the issue title onto the bare
# kenn-forge/issue-<n> form, e.g. kenn-forge/issue-1234-add-foo-to-bar.
# Set to "bare" to keep the legacy kenn-forge/issue-<n> form.
# issue_workspace_branch_style = "slug"

[terminal]

[activity]
view_mode = "threaded"
time_range = "7d"
collapse_threads = true

[[platforms]]
type = "gitlab"
host = "gitlab.com"
token_env = "KENN_FORGE_GITLAB_TOKEN"

# Tokens are selected by provider and host. Read access is enough for sync;
# write access is needed only for comments, state edits, approvals, and merges.
[[platforms]]
type = "forgejo"
host = "codeberg.org"
token_env = "KENN_FORGE_FORGEJO_TOKEN"

[[platforms]]
type = "forgejo"
host = "forgejo.internal.example"
token_env = "FORGEJO_INTERNAL_TOKEN"

[[platforms]]
type = "gitea"
host = "gitea.com"
token_env = "KENN_FORGE_GITEA_TOKEN"

[[platforms]]
type = "gitea"
host = "gitea.internal.example"
token_env = "GITEA_INTERNAL_TOKEN"

[[repos]]
owner = "apache"
name = "arrow"

[[repos]]
owner = "ibis-project"
name = "ibis"

[[repos]]
platform = "gitlab"
platform_host = "gitlab.com"
# GitLab owner can include nested namespaces. repo_path is optional when it is
# exactly owner/name, but useful when preserving provider-canonical casing.
owner = "my-group/subgroup"
name = "my-project"
repo_path = "my-group/subgroup/my-project"

[[repos]]
platform = "forgejo"
platform_host = "codeberg.org"
owner = "forgejo"
name = "forgejo"

[[repos]]
platform = "forgejo"
platform_host = "forgejo.internal.example"
owner = "team"
name = "service"

[[repos]]
platform = "gitea"
platform_host = "gitea.com"
owner = "gitea"
name = "tea"

[[repos]]
platform = "gitea"
platform_host = "gitea.internal.example"
owner = "team"
name = "ops"

# Optional private PR cards. Install an adapter implementing the external-context
# JSON contract, then configure it here (this section is not editable in Settings).
# [[external_context]]
# id = "performance"
# name = "Performance"
# command = ["/opt/forge-integrations/performance-context"]
# timeout = "10s"