1package config
  2
  3import (
  4	"context"
  5	"encoding/json"
  6	"fmt"
  7	"io"
  8	"log/slog"
  9	"maps"
 10	"os"
 11	"os/exec"
 12	"path/filepath"
 13	"runtime"
 14	"slices"
 15	"strconv"
 16	"strings"
 17	"testing"
 18
 19	"github.com/charmbracelet/catwalk/pkg/catwalk"
 20	"github.com/charmbracelet/crush/internal/csync"
 21	"github.com/charmbracelet/crush/internal/env"
 22	"github.com/charmbracelet/crush/internal/fsext"
 23	"github.com/charmbracelet/crush/internal/home"
 24	"github.com/charmbracelet/crush/internal/log"
 25	powernapConfig "github.com/charmbracelet/x/powernap/pkg/config"
 26)
 27
 28const defaultCatwalkURL = "https://catwalk.charm.sh"
 29
 30// LoadReader config via io.Reader.
 31func LoadReader(fd io.Reader) (*Config, error) {
 32	data, err := io.ReadAll(fd)
 33	if err != nil {
 34		return nil, err
 35	}
 36
 37	var config Config
 38	err = json.Unmarshal(data, &config)
 39	if err != nil {
 40		return nil, err
 41	}
 42	return &config, err
 43}
 44
 45// Load loads the configuration from the default paths.
 46func Load(workingDir, dataDir string, debug bool) (*Config, error) {
 47	configPaths := lookupConfigs(workingDir)
 48
 49	cfg, err := loadFromConfigPaths(configPaths)
 50	if err != nil {
 51		return nil, fmt.Errorf("failed to load config from paths %v: %w", configPaths, err)
 52	}
 53
 54	cfg.dataConfigDir = GlobalConfigData()
 55
 56	cfg.setDefaults(workingDir, dataDir)
 57
 58	if debug {
 59		cfg.Options.Debug = true
 60	}
 61
 62	// Setup logs
 63	log.Setup(
 64		filepath.Join(cfg.Options.DataDirectory, "logs", fmt.Sprintf("%s.log", appName)),
 65		cfg.Options.Debug,
 66	)
 67
 68	if !isInsideWorktree() {
 69		const depth = 2
 70		const items = 100
 71		slog.Warn("No git repository detected in working directory, will limit file walk operations", "depth", depth, "items", items)
 72		assignIfNil(&cfg.Tools.Ls.MaxDepth, depth)
 73		assignIfNil(&cfg.Tools.Ls.MaxItems, items)
 74		assignIfNil(&cfg.Options.TUI.Completions.MaxDepth, depth)
 75		assignIfNil(&cfg.Options.TUI.Completions.MaxItems, items)
 76	}
 77
 78	// Load known providers, this loads the config from catwalk
 79	providers, err := Providers(cfg)
 80	if err != nil {
 81		return nil, err
 82	}
 83	cfg.knownProviders = providers
 84
 85	env := env.New()
 86	// Configure providers
 87	valueResolver := NewShellVariableResolver(env)
 88	cfg.resolver = valueResolver
 89	if err := cfg.configureProviders(env, valueResolver, cfg.knownProviders); err != nil {
 90		return nil, fmt.Errorf("failed to configure providers: %w", err)
 91	}
 92
 93	if !cfg.IsConfigured() {
 94		slog.Warn("No providers configured")
 95		return cfg, nil
 96	}
 97
 98	if err := cfg.configureSelectedModels(cfg.knownProviders); err != nil {
 99		return nil, fmt.Errorf("failed to configure selected models: %w", err)
100	}
101	cfg.SetupAgents()
102	return cfg, nil
103}
104
105func PushPopCrushEnv() func() {
106	found := []string{}
107	for _, ev := range os.Environ() {
108		if strings.HasPrefix(ev, "CRUSH_") {
109			pair := strings.SplitN(ev, "=", 2)
110			if len(pair) != 2 {
111				continue
112			}
113			found = append(found, strings.TrimPrefix(pair[0], "CRUSH_"))
114		}
115	}
116	backups := make(map[string]string)
117	for _, ev := range found {
118		backups[ev] = os.Getenv(ev)
119	}
120
121	for _, ev := range found {
122		os.Setenv(ev, os.Getenv("CRUSH_"+ev))
123	}
124
125	restore := func() {
126		for k, v := range backups {
127			os.Setenv(k, v)
128		}
129	}
130	return restore
131}
132
133func (c *Config) configureProviders(env env.Env, resolver VariableResolver, knownProviders []catwalk.Provider) error {
134	knownProviderNames := make(map[string]bool)
135	restore := PushPopCrushEnv()
136	defer restore()
137
138	for _, p := range knownProviders {
139		knownProviderNames[string(p.ID)] = true
140		config, configExists := c.Providers.Get(string(p.ID))
141		// if the user configured a known provider we need to allow it to override a couple of parameters
142		if configExists {
143			if config.BaseURL != "" {
144				p.APIEndpoint = config.BaseURL
145			}
146			if config.APIKey != "" {
147				p.APIKey = config.APIKey
148			}
149			if len(config.Models) > 0 {
150				models := []catwalk.Model{}
151				seen := make(map[string]bool)
152
153				for _, model := range config.Models {
154					if seen[model.ID] {
155						continue
156					}
157					seen[model.ID] = true
158					if model.Name == "" {
159						model.Name = model.ID
160					}
161					models = append(models, model)
162				}
163				for _, model := range p.Models {
164					if seen[model.ID] {
165						continue
166					}
167					seen[model.ID] = true
168					if model.Name == "" {
169						model.Name = model.ID
170					}
171					models = append(models, model)
172				}
173
174				p.Models = models
175			}
176		}
177
178		headers := map[string]string{}
179		if len(p.DefaultHeaders) > 0 {
180			maps.Copy(headers, p.DefaultHeaders)
181		}
182		if len(config.ExtraHeaders) > 0 {
183			maps.Copy(headers, config.ExtraHeaders)
184		}
185		prepared := ProviderConfig{
186			ID:                 string(p.ID),
187			Name:               p.Name,
188			BaseURL:            p.APIEndpoint,
189			APIKey:             p.APIKey,
190			APIKeyTemplate:     p.APIKey, // Store original template for re-resolution
191			OAuthToken:         config.OAuthToken,
192			Type:               p.Type,
193			Disable:            config.Disable,
194			SystemPromptPrefix: config.SystemPromptPrefix,
195			ExtraHeaders:       headers,
196			ExtraBody:          config.ExtraBody,
197			ExtraParams:        make(map[string]string),
198			Models:             p.Models,
199		}
200
201		if p.ID == catwalk.InferenceProviderAnthropic && config.OAuthToken != nil {
202			prepared.SetupClaudeCode()
203		}
204
205		switch p.ID {
206		// Handle specific providers that require additional configuration
207		case catwalk.InferenceProviderVertexAI:
208			if !hasVertexCredentials(env) {
209				if configExists {
210					slog.Warn("Skipping Vertex AI provider due to missing credentials")
211					c.Providers.Del(string(p.ID))
212				}
213				continue
214			}
215			prepared.ExtraParams["project"] = env.Get("VERTEXAI_PROJECT")
216			prepared.ExtraParams["location"] = env.Get("VERTEXAI_LOCATION")
217		case catwalk.InferenceProviderAzure:
218			endpoint, err := resolver.ResolveValue(p.APIEndpoint)
219			if err != nil || endpoint == "" {
220				if configExists {
221					slog.Warn("Skipping Azure provider due to missing API endpoint", "provider", p.ID, "error", err)
222					c.Providers.Del(string(p.ID))
223				}
224				continue
225			}
226			prepared.BaseURL = endpoint
227			prepared.ExtraParams["apiVersion"] = env.Get("AZURE_OPENAI_API_VERSION")
228		case catwalk.InferenceProviderBedrock:
229			if !hasAWSCredentials(env) {
230				if configExists {
231					slog.Warn("Skipping Bedrock provider due to missing AWS credentials")
232					c.Providers.Del(string(p.ID))
233				}
234				continue
235			}
236			prepared.ExtraParams["region"] = env.Get("AWS_REGION")
237			if prepared.ExtraParams["region"] == "" {
238				prepared.ExtraParams["region"] = env.Get("AWS_DEFAULT_REGION")
239			}
240			for _, model := range p.Models {
241				if !strings.HasPrefix(model.ID, "anthropic.") {
242					return fmt.Errorf("bedrock provider only supports anthropic models for now, found: %s", model.ID)
243				}
244			}
245		default:
246			// if the provider api or endpoint are missing we skip them
247			v, err := resolver.ResolveValue(p.APIKey)
248			if v == "" || err != nil {
249				if configExists {
250					slog.Warn("Skipping provider due to missing API key", "provider", p.ID)
251					c.Providers.Del(string(p.ID))
252				}
253				continue
254			}
255		}
256		c.Providers.Set(string(p.ID), prepared)
257	}
258
259	// validate the custom providers
260	for id, providerConfig := range c.Providers.Seq2() {
261		if knownProviderNames[id] {
262			continue
263		}
264
265		// Make sure the provider ID is set
266		providerConfig.ID = id
267		if providerConfig.Name == "" {
268			providerConfig.Name = id // Use ID as name if not set
269		}
270		// default to OpenAI if not set
271		if providerConfig.Type == "" {
272			providerConfig.Type = catwalk.TypeOpenAICompat
273		}
274		if !slices.Contains(catwalk.KnownProviderTypes(), providerConfig.Type) {
275			slog.Warn("Skipping custom provider due to unsupported provider type", "provider", id)
276			c.Providers.Del(id)
277			continue
278		}
279
280		if providerConfig.Disable {
281			slog.Debug("Skipping custom provider due to disable flag", "provider", id)
282			c.Providers.Del(id)
283			continue
284		}
285		if providerConfig.APIKey == "" {
286			slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
287		}
288		if providerConfig.BaseURL == "" {
289			slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id)
290			c.Providers.Del(id)
291			continue
292		}
293		if len(providerConfig.Models) == 0 {
294			slog.Warn("Skipping custom provider because the provider has no models", "provider", id)
295			c.Providers.Del(id)
296			continue
297		}
298		apiKey, err := resolver.ResolveValue(providerConfig.APIKey)
299		if apiKey == "" || err != nil {
300			slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
301		}
302		baseURL, err := resolver.ResolveValue(providerConfig.BaseURL)
303		if baseURL == "" || err != nil {
304			slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id, "error", err)
305			c.Providers.Del(id)
306			continue
307		}
308
309		c.Providers.Set(id, providerConfig)
310	}
311	return nil
312}
313
314func (c *Config) setDefaults(workingDir, dataDir string) {
315	c.workingDir = workingDir
316	if c.Options == nil {
317		c.Options = &Options{}
318	}
319	if c.Options.TUI == nil {
320		c.Options.TUI = &TUIOptions{}
321	}
322	if c.Options.ContextPaths == nil {
323		c.Options.ContextPaths = []string{}
324	}
325	if dataDir != "" {
326		c.Options.DataDirectory = dataDir
327	} else if c.Options.DataDirectory == "" {
328		if path, ok := fsext.LookupClosest(workingDir, defaultDataDirectory); ok {
329			c.Options.DataDirectory = path
330		} else {
331			c.Options.DataDirectory = filepath.Join(workingDir, defaultDataDirectory)
332		}
333	}
334	if c.Providers == nil {
335		c.Providers = csync.NewMap[string, ProviderConfig]()
336	}
337	if c.Models == nil {
338		c.Models = make(map[SelectedModelType]SelectedModel)
339	}
340	if c.RecentModels == nil {
341		c.RecentModels = make(map[SelectedModelType][]SelectedModel)
342	}
343	if c.MCP == nil {
344		c.MCP = make(map[string]MCPConfig)
345	}
346	if c.LSP == nil {
347		c.LSP = make(map[string]LSPConfig)
348	}
349
350	// Apply defaults to LSP configurations
351	c.applyLSPDefaults()
352
353	// Add the default context paths if they are not already present
354	c.Options.ContextPaths = append(defaultContextPaths, c.Options.ContextPaths...)
355	slices.Sort(c.Options.ContextPaths)
356	c.Options.ContextPaths = slices.Compact(c.Options.ContextPaths)
357
358	if str, ok := os.LookupEnv("CRUSH_DISABLE_PROVIDER_AUTO_UPDATE"); ok {
359		c.Options.DisableProviderAutoUpdate, _ = strconv.ParseBool(str)
360	}
361
362	if c.Options.Attribution == nil {
363		c.Options.Attribution = &Attribution{
364			TrailerStyle:  TrailerStyleAssistedBy,
365			GeneratedWith: true,
366		}
367	} else if c.Options.Attribution.TrailerStyle == "" {
368		// Migrate deprecated co_authored_by or apply default
369		if c.Options.Attribution.CoAuthoredBy != nil {
370			if *c.Options.Attribution.CoAuthoredBy {
371				c.Options.Attribution.TrailerStyle = TrailerStyleCoAuthoredBy
372			} else {
373				c.Options.Attribution.TrailerStyle = TrailerStyleNone
374			}
375		} else {
376			c.Options.Attribution.TrailerStyle = TrailerStyleAssistedBy
377		}
378	}
379	if c.Options.InitializeAs == "" {
380		c.Options.InitializeAs = defaultInitializeAs
381	}
382}
383
384// applyLSPDefaults applies default values from powernap to LSP configurations
385func (c *Config) applyLSPDefaults() {
386	// Get powernap's default configuration
387	configManager := powernapConfig.NewManager()
388	configManager.LoadDefaults()
389
390	// Apply defaults to each LSP configuration
391	for name, cfg := range c.LSP {
392		// Try to get defaults from powernap based on name or command name.
393		base, ok := configManager.GetServer(name)
394		if !ok {
395			base, ok = configManager.GetServer(cfg.Command)
396			if !ok {
397				continue
398			}
399		}
400		if cfg.Options == nil {
401			cfg.Options = base.Settings
402		}
403		if cfg.InitOptions == nil {
404			cfg.InitOptions = base.InitOptions
405		}
406		if len(cfg.FileTypes) == 0 {
407			cfg.FileTypes = base.FileTypes
408		}
409		if len(cfg.RootMarkers) == 0 {
410			cfg.RootMarkers = base.RootMarkers
411		}
412		if cfg.Command == "" {
413			cfg.Command = base.Command
414		}
415		if len(cfg.Args) == 0 {
416			cfg.Args = base.Args
417		}
418		if len(cfg.Env) == 0 {
419			cfg.Env = base.Environment
420		}
421		// Update the config in the map
422		c.LSP[name] = cfg
423	}
424}
425
426func (c *Config) defaultModelSelection(knownProviders []catwalk.Provider) (largeModel SelectedModel, smallModel SelectedModel, err error) {
427	if len(knownProviders) == 0 && c.Providers.Len() == 0 {
428		err = fmt.Errorf("no providers configured, please configure at least one provider")
429		return largeModel, smallModel, err
430	}
431
432	// Use the first provider enabled based on the known providers order
433	// if no provider found that is known use the first provider configured
434	for _, p := range knownProviders {
435		providerConfig, ok := c.Providers.Get(string(p.ID))
436		if !ok || providerConfig.Disable {
437			continue
438		}
439		defaultLargeModel := c.GetModel(string(p.ID), p.DefaultLargeModelID)
440		if defaultLargeModel == nil {
441			err = fmt.Errorf("default large model %s not found for provider %s", p.DefaultLargeModelID, p.ID)
442			return largeModel, smallModel, err
443		}
444		largeModel = SelectedModel{
445			Provider:        string(p.ID),
446			Model:           defaultLargeModel.ID,
447			MaxTokens:       defaultLargeModel.DefaultMaxTokens,
448			ReasoningEffort: defaultLargeModel.DefaultReasoningEffort,
449		}
450
451		defaultSmallModel := c.GetModel(string(p.ID), p.DefaultSmallModelID)
452		if defaultSmallModel == nil {
453			err = fmt.Errorf("default small model %s not found for provider %s", p.DefaultSmallModelID, p.ID)
454			return largeModel, smallModel, err
455		}
456		smallModel = SelectedModel{
457			Provider:        string(p.ID),
458			Model:           defaultSmallModel.ID,
459			MaxTokens:       defaultSmallModel.DefaultMaxTokens,
460			ReasoningEffort: defaultSmallModel.DefaultReasoningEffort,
461		}
462		return largeModel, smallModel, err
463	}
464
465	enabledProviders := c.EnabledProviders()
466	slices.SortFunc(enabledProviders, func(a, b ProviderConfig) int {
467		return strings.Compare(a.ID, b.ID)
468	})
469
470	if len(enabledProviders) == 0 {
471		err = fmt.Errorf("no providers configured, please configure at least one provider")
472		return largeModel, smallModel, err
473	}
474
475	providerConfig := enabledProviders[0]
476	if len(providerConfig.Models) == 0 {
477		err = fmt.Errorf("provider %s has no models configured", providerConfig.ID)
478		return largeModel, smallModel, err
479	}
480	defaultLargeModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
481	largeModel = SelectedModel{
482		Provider:  providerConfig.ID,
483		Model:     defaultLargeModel.ID,
484		MaxTokens: defaultLargeModel.DefaultMaxTokens,
485	}
486	defaultSmallModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
487	smallModel = SelectedModel{
488		Provider:  providerConfig.ID,
489		Model:     defaultSmallModel.ID,
490		MaxTokens: defaultSmallModel.DefaultMaxTokens,
491	}
492	return largeModel, smallModel, err
493}
494
495func (c *Config) configureSelectedModels(knownProviders []catwalk.Provider) error {
496	defaultLarge, defaultSmall, err := c.defaultModelSelection(knownProviders)
497	if err != nil {
498		return fmt.Errorf("failed to select default models: %w", err)
499	}
500	large, small := defaultLarge, defaultSmall
501
502	largeModelSelected, largeModelConfigured := c.Models[SelectedModelTypeLarge]
503	if largeModelConfigured {
504		if largeModelSelected.Model != "" {
505			large.Model = largeModelSelected.Model
506		}
507		if largeModelSelected.Provider != "" {
508			large.Provider = largeModelSelected.Provider
509		}
510		model := c.GetModel(large.Provider, large.Model)
511		if model == nil {
512			large = defaultLarge
513			// override the model type to large
514			err := c.UpdatePreferredModel(SelectedModelTypeLarge, large)
515			if err != nil {
516				return fmt.Errorf("failed to update preferred large model: %w", err)
517			}
518		} else {
519			if largeModelSelected.MaxTokens > 0 {
520				large.MaxTokens = largeModelSelected.MaxTokens
521			} else {
522				large.MaxTokens = model.DefaultMaxTokens
523			}
524			if largeModelSelected.ReasoningEffort != "" {
525				large.ReasoningEffort = largeModelSelected.ReasoningEffort
526			}
527			large.Think = largeModelSelected.Think
528			if largeModelSelected.Temperature != nil {
529				large.Temperature = largeModelSelected.Temperature
530			}
531			if largeModelSelected.TopP != nil {
532				large.TopP = largeModelSelected.TopP
533			}
534			if largeModelSelected.TopK != nil {
535				large.TopK = largeModelSelected.TopK
536			}
537			if largeModelSelected.FrequencyPenalty != nil {
538				large.FrequencyPenalty = largeModelSelected.FrequencyPenalty
539			}
540			if largeModelSelected.PresencePenalty != nil {
541				large.PresencePenalty = largeModelSelected.PresencePenalty
542			}
543		}
544	}
545	smallModelSelected, smallModelConfigured := c.Models[SelectedModelTypeSmall]
546	if smallModelConfigured {
547		if smallModelSelected.Model != "" {
548			small.Model = smallModelSelected.Model
549		}
550		if smallModelSelected.Provider != "" {
551			small.Provider = smallModelSelected.Provider
552		}
553
554		model := c.GetModel(small.Provider, small.Model)
555		if model == nil {
556			small = defaultSmall
557			// override the model type to small
558			err := c.UpdatePreferredModel(SelectedModelTypeSmall, small)
559			if err != nil {
560				return fmt.Errorf("failed to update preferred small model: %w", err)
561			}
562		} else {
563			if smallModelSelected.MaxTokens > 0 {
564				small.MaxTokens = smallModelSelected.MaxTokens
565			} else {
566				small.MaxTokens = model.DefaultMaxTokens
567			}
568			if smallModelSelected.ReasoningEffort != "" {
569				small.ReasoningEffort = smallModelSelected.ReasoningEffort
570			}
571			if smallModelSelected.Temperature != nil {
572				small.Temperature = smallModelSelected.Temperature
573			}
574			if smallModelSelected.TopP != nil {
575				small.TopP = smallModelSelected.TopP
576			}
577			if smallModelSelected.TopK != nil {
578				small.TopK = smallModelSelected.TopK
579			}
580			if smallModelSelected.FrequencyPenalty != nil {
581				small.FrequencyPenalty = smallModelSelected.FrequencyPenalty
582			}
583			if smallModelSelected.PresencePenalty != nil {
584				small.PresencePenalty = smallModelSelected.PresencePenalty
585			}
586			small.Think = smallModelSelected.Think
587		}
588	}
589	c.Models[SelectedModelTypeLarge] = large
590	c.Models[SelectedModelTypeSmall] = small
591	return nil
592}
593
594// lookupConfigs searches config files recursively from CWD up to FS root
595func lookupConfigs(cwd string) []string {
596	// prepend default config paths
597	configPaths := []string{
598		GlobalConfig(),
599		GlobalConfigData(),
600	}
601
602	configNames := []string{appName + ".json", "." + appName + ".json"}
603
604	foundConfigs, err := fsext.Lookup(cwd, configNames...)
605	if err != nil {
606		// returns at least default configs
607		return configPaths
608	}
609
610	// reverse order so last config has more priority
611	slices.Reverse(foundConfigs)
612
613	return append(configPaths, foundConfigs...)
614}
615
616func loadFromConfigPaths(configPaths []string) (*Config, error) {
617	var configs []io.Reader
618
619	for _, path := range configPaths {
620		fd, err := os.Open(path)
621		if err != nil {
622			if os.IsNotExist(err) {
623				continue
624			}
625			return nil, fmt.Errorf("failed to open config file %s: %w", path, err)
626		}
627		defer fd.Close()
628
629		configs = append(configs, fd)
630	}
631
632	return loadFromReaders(configs)
633}
634
635func loadFromReaders(readers []io.Reader) (*Config, error) {
636	if len(readers) == 0 {
637		return &Config{}, nil
638	}
639
640	merged, err := Merge(readers)
641	if err != nil {
642		return nil, fmt.Errorf("failed to merge configuration readers: %w", err)
643	}
644
645	return LoadReader(merged)
646}
647
648func hasVertexCredentials(env env.Env) bool {
649	hasProject := env.Get("VERTEXAI_PROJECT") != ""
650	hasLocation := env.Get("VERTEXAI_LOCATION") != ""
651	return hasProject && hasLocation
652}
653
654func hasAWSCredentials(env env.Env) bool {
655	if env.Get("AWS_BEARER_TOKEN_BEDROCK") != "" {
656		return true
657	}
658
659	if env.Get("AWS_ACCESS_KEY_ID") != "" && env.Get("AWS_SECRET_ACCESS_KEY") != "" {
660		return true
661	}
662
663	if env.Get("AWS_PROFILE") != "" || env.Get("AWS_DEFAULT_PROFILE") != "" {
664		return true
665	}
666
667	if env.Get("AWS_REGION") != "" || env.Get("AWS_DEFAULT_REGION") != "" {
668		return true
669	}
670
671	if env.Get("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") != "" ||
672		env.Get("AWS_CONTAINER_CREDENTIALS_FULL_URI") != "" {
673		return true
674	}
675
676	if _, err := os.Stat(filepath.Join(home.Dir(), ".aws/credentials")); err == nil && !testing.Testing() {
677		return true
678	}
679
680	return false
681}
682
683// GlobalConfig returns the global configuration file path for the application.
684func GlobalConfig() string {
685	xdgConfigHome := os.Getenv("XDG_CONFIG_HOME")
686	if xdgConfigHome != "" {
687		return filepath.Join(xdgConfigHome, appName, fmt.Sprintf("%s.json", appName))
688	}
689
690	return filepath.Join(home.Dir(), ".config", appName, fmt.Sprintf("%s.json", appName))
691}
692
693// GlobalConfigData returns the path to the main data directory for the application.
694// this config is used when the app overrides configurations instead of updating the global config.
695func GlobalConfigData() string {
696	xdgDataHome := os.Getenv("XDG_DATA_HOME")
697	if xdgDataHome != "" {
698		return filepath.Join(xdgDataHome, appName, fmt.Sprintf("%s.json", appName))
699	}
700
701	// return the path to the main data directory
702	// for windows, it should be in `%LOCALAPPDATA%/crush/`
703	// for linux and macOS, it should be in `$HOME/.local/share/crush/`
704	if runtime.GOOS == "windows" {
705		localAppData := os.Getenv("LOCALAPPDATA")
706		if localAppData == "" {
707			localAppData = filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local")
708		}
709		return filepath.Join(localAppData, appName, fmt.Sprintf("%s.json", appName))
710	}
711
712	return filepath.Join(home.Dir(), ".local", "share", appName, fmt.Sprintf("%s.json", appName))
713}
714
715func assignIfNil[T any](ptr **T, val T) {
716	if *ptr == nil {
717		*ptr = &val
718	}
719}
720
721func isInsideWorktree() bool {
722	bts, err := exec.CommandContext(
723		context.Background(),
724		"git", "rev-parse",
725		"--is-inside-work-tree",
726	).CombinedOutput()
727	return err == nil && strings.TrimSpace(string(bts)) == "true"
728}