load.go

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