forge

Sep 14, 2026

Changes in this version

+ var ErrForgeNotLinked = errors.NewSentinel("gtb.setup.forge.not_linked", ...)

+ func ModuleFor(provider string) (string, bool)

+ func UnlinkedError(missing []UnlinkedForge) error

+ type UnlinkedForge struct

+ Feature props.FeatureID

+ Label string

+ Module string

+ Provider string

+ func Unlinked(tool props.Tool) []UnlinkedForge

Aug 4, 2026

Changes in this version

+ const BitbucketFeature

+ const CodebergFeature

+ const GiteaFeature

+ const GithubFeature

+ const GitlabFeature

+ const PackagePath

+ func NewCmdInitForge(p *props.Props, profile Profile) *cobra.Command

+ func RunForgeInit(ctx context.Context, p *props.Props, cfg setup.Editor, profile Profile) error

+ func RunForgeInitCmd(ctx context.Context, p *props.Props, dir string, profile Profile) error

+ type Display struct

+ Host string

+ ID props.FeatureID

+ Label string

+ NestedNamespaces bool

+ RepoDescription string

+ RepoPlaceholder string

+ func DisplayFor(id props.FeatureID) (Display, bool)

+ func Displays() []Display

type InitialiserOption

+ func WithSSHForms(opts ...ConfigureSSHKeyOption) InitialiserOption

type Profile

+ LoginClientID string

+ LoginClientIDHost string

+ NestedNamespaces bool

+ RepoDescription string

+ RepoPlaceholder string

Jul 31, 2026

Changes in this version

type Profile

+ TokenCreateURLTemplate string

+ TokenScopes string

Jul 22, 2026

Changes in this version

+ func ConfigureSSHKey(profile Profile, props *props.Props, cfg config.Reader, ...) (string, string, error)

+ func NewCmdInitBitbucket(p *props.Props) *cobra.Command

+ func NewCmdInitGitHub(p *props.Props) *cobra.Command

+ func RunBitbucketInit(p *props.Props, cfg setup.Editor, opts ...DualFormOption) error

+ func RunBitbucketInitCmd(ctx context.Context, p *props.Props, dir string, opts ...DualFormOption) error

+ func RunGitHubInit(p *props.Props, cfg setup.Editor) error

+ func RunGitHubInitCmd(ctx context.Context, p *props.Props, dir string) error

+ type AuthConfig struct

+ EnvVarName string

+ FetchToken bool

+ StorageMode credentials.Mode

+ Token string

+ type AuthFormOption func(*authFormConfig)

+ func WithAuthForm(creator func(*AuthConfig) []*huh.Form, ...) AuthFormOption

+ type ConfigureSSHKeyOption func(*configureSSHKeyConfig)

+ func WithGenerateKeyOptions(opts ...GenerateKeyOption) ConfigureSSHKeyOption

+ func WithSSHKeyPathForm(creator func(*string) *huh.Form) ConfigureSSHKeyOption

+ func WithSSHKeySelectForm(creator func(*string, []huh.Option[string]) *huh.Form) ConfigureSSHKeyOption

+ type CredentialShape int

+ const DualUserPass

+ const SingleToken

+ type DualConfig struct

+ AppPassword string

+ AppPasswordEnvName string

+ StorageMode credentials.Mode

+ Username string

+ UsernameEnvName string

+ type DualFormOption func(*dualFormConfig)

+ func WithDualForm(creator func(*DualConfig) []*huh.Form) DualFormOption

+ type GenerateKeyOption func(*generateKeyConfig)

+ func WithKeyManager(factory func(config.Reader) (forgeapi.KeyManager, error)) GenerateKeyOption

+ func WithPassphraseForm(creator func(*string) *huh.Form) GenerateKeyOption

+ func WithUploadConfirmForm(creator func(*bool) *huh.Form) GenerateKeyOption

+ type Initialiser struct

+ SkipKey bool

+ SkipLogin bool

+ func New(_ *props.Props, profile Profile, opts ...InitialiserOption) *Initialiser

+ func NewBitbucketInitialiser(p *props.Props, opts ...InitialiserOption) *Initialiser

+ func NewGitHubInitialiser(p *props.Props, skipLogin, skipKey bool, opts ...InitialiserOption) *Initialiser

+ func (i *Initialiser) Configure(p *props.Props, cfg setup.Editor) error

+ func (i *Initialiser) IsConfigured(cfg config.Reader) bool

+ func (i *Initialiser) Name() string

+ type InitialiserOption func(*Initialiser)

+ func WithAuthForms(opts ...AuthFormOption) InitialiserOption

+ func WithDualForms(opts ...DualFormOption) InitialiserOption

+ func WithPrompter(p forgeapi.Prompter) InitialiserOption

+ func WithProviderFactory(fn func(config.Reader) (forgeapi.Provider, error)) InitialiserOption

+ type Profile struct

+ ConfigPrefix string

+ Credential CredentialShape

+ DisplayName string

+ FallbackEnv string

+ Feature props.FeatureCmd

+ Host string

+ KeychainAccount string

+ Label string

+ OffersLogin bool

+ OffersSSH bool

+ PassFallbackEnv string

+ Provider string

+ UserFallbackEnv string