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 var (
223 project = env.Get("VERTEXAI_PROJECT")
224 location = env.Get("VERTEXAI_LOCATION")
225 )
226 if project == "" || location == "" {
227 if configExists {
228 slog.Warn("Skipping Vertex AI provider due to missing credentials")
229 c.Providers.Del(string(p.ID))
230 }
231 continue
232 }
233 prepared.ExtraParams["project"] = project
234 prepared.ExtraParams["location"] = location
235 case catwalk.InferenceProviderAzure:
236 endpoint, err := resolver.ResolveValue(p.APIEndpoint)
237 if err != nil || endpoint == "" {
238 if configExists {
239 slog.Warn("Skipping Azure provider due to missing API endpoint", "provider", p.ID, "error", err)
240 c.Providers.Del(string(p.ID))
241 }
242 continue
243 }
244 prepared.BaseURL = endpoint
245 prepared.ExtraParams["apiVersion"] = env.Get("AZURE_OPENAI_API_VERSION")
246 case catwalk.InferenceProviderBedrock:
247 if !hasAWSCredentials(env) {
248 if configExists {
249 slog.Warn("Skipping Bedrock provider due to missing AWS credentials")
250 c.Providers.Del(string(p.ID))
251 }
252 continue
253 }
254 prepared.ExtraParams["region"] = env.Get("AWS_REGION")
255 if prepared.ExtraParams["region"] == "" {
256 prepared.ExtraParams["region"] = env.Get("AWS_DEFAULT_REGION")
257 }
258 for _, model := range p.Models {
259 if !strings.HasPrefix(model.ID, "anthropic.") {
260 return fmt.Errorf("bedrock provider only supports anthropic models for now, found: %s", model.ID)
261 }
262 }
263 default:
264 // if the provider api or endpoint are missing we skip them
265 v, err := resolver.ResolveValue(p.APIKey)
266 if v == "" || err != nil {
267 if configExists {
268 slog.Warn("Skipping provider due to missing API key", "provider", p.ID)
269 c.Providers.Del(string(p.ID))
270 }
271 continue
272 }
273 }
274 c.Providers.Set(string(p.ID), prepared)
275 }
276
277 // validate the custom providers
278 for id, providerConfig := range c.Providers.Seq2() {
279 if knownProviderNames[id] {
280 continue
281 }
282
283 // Make sure the provider ID is set
284 providerConfig.ID = id
285 providerConfig.Name = cmp.Or(providerConfig.Name, id) // Use ID as name if not set
286 // default to OpenAI if not set
287 providerConfig.Type = cmp.Or(providerConfig.Type, catwalk.TypeOpenAICompat)
288 if !slices.Contains(catwalk.KnownProviderTypes(), providerConfig.Type) && providerConfig.Type != hyper.Name {
289 slog.Warn("Skipping custom provider due to unsupported provider type", "provider", id)
290 c.Providers.Del(id)
291 continue
292 }
293
294 if providerConfig.Disable {
295 slog.Debug("Skipping custom provider due to disable flag", "provider", id)
296 c.Providers.Del(id)
297 continue
298 }
299 if providerConfig.APIKey == "" {
300 slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
301 }
302 if providerConfig.BaseURL == "" {
303 slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id)
304 c.Providers.Del(id)
305 continue
306 }
307 if len(providerConfig.Models) == 0 {
308 slog.Warn("Skipping custom provider because the provider has no models", "provider", id)
309 c.Providers.Del(id)
310 continue
311 }
312 apiKey, err := resolver.ResolveValue(providerConfig.APIKey)
313 if apiKey == "" || err != nil {
314 slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
315 }
316 baseURL, err := resolver.ResolveValue(providerConfig.BaseURL)
317 if baseURL == "" || err != nil {
318 slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id, "error", err)
319 c.Providers.Del(id)
320 continue
321 }
322
323 for k, v := range providerConfig.ExtraHeaders {
324 resolved, err := resolver.ResolveValue(v)
325 if err != nil {
326 slog.Error("Could not resolve provider header", "err", err.Error())
327 continue
328 }
329 providerConfig.ExtraHeaders[k] = resolved
330 }
331
332 c.Providers.Set(id, providerConfig)
333 }
334
335 if c.Providers.Len() == 0 && c.Options.DisableDefaultProviders {
336 return fmt.Errorf("default providers are disabled and there are no custom providers are configured")
337 }
338
339 return nil
340}
341
342func (c *Config) setDefaults(workingDir, dataDir string) {
343 c.workingDir = workingDir
344 if c.Options == nil {
345 c.Options = &Options{}
346 }
347 if c.Options.TUI == nil {
348 c.Options.TUI = &TUIOptions{}
349 }
350 if dataDir != "" {
351 c.Options.DataDirectory = dataDir
352 } else if c.Options.DataDirectory == "" {
353 if path, ok := fsext.LookupClosest(workingDir, defaultDataDirectory); ok {
354 c.Options.DataDirectory = path
355 } else {
356 c.Options.DataDirectory = filepath.Join(workingDir, defaultDataDirectory)
357 }
358 }
359 if c.Providers == nil {
360 c.Providers = csync.NewMap[string, ProviderConfig]()
361 }
362 if c.Models == nil {
363 c.Models = make(map[SelectedModelType]SelectedModel)
364 }
365 if c.RecentModels == nil {
366 c.RecentModels = make(map[SelectedModelType][]SelectedModel)
367 }
368 if c.MCP == nil {
369 c.MCP = make(map[string]MCPConfig)
370 }
371 if c.LSP == nil {
372 c.LSP = make(map[string]LSPConfig)
373 }
374
375 // Apply defaults to LSP configurations
376 c.applyLSPDefaults()
377
378 // Add the default context paths if they are not already present
379 c.Options.ContextPaths = append(defaultContextPaths, c.Options.ContextPaths...)
380 slices.Sort(c.Options.ContextPaths)
381 c.Options.ContextPaths = slices.Compact(c.Options.ContextPaths)
382
383 // Add the default skills directories if not already present.
384 for _, dir := range GlobalSkillsDirs() {
385 if !slices.Contains(c.Options.SkillsPaths, dir) {
386 c.Options.SkillsPaths = append(c.Options.SkillsPaths, dir)
387 }
388 }
389
390 if str, ok := os.LookupEnv("CRUSH_DISABLE_PROVIDER_AUTO_UPDATE"); ok {
391 c.Options.DisableProviderAutoUpdate, _ = strconv.ParseBool(str)
392 }
393
394 if str, ok := os.LookupEnv("CRUSH_DISABLE_DEFAULT_PROVIDERS"); ok {
395 c.Options.DisableDefaultProviders, _ = strconv.ParseBool(str)
396 }
397
398 if c.Options.Attribution == nil {
399 c.Options.Attribution = &Attribution{
400 TrailerStyle: TrailerStyleAssistedBy,
401 GeneratedWith: true,
402 }
403 } else if c.Options.Attribution.TrailerStyle == "" {
404 // Migrate deprecated co_authored_by or apply default
405 if c.Options.Attribution.CoAuthoredBy != nil {
406 if *c.Options.Attribution.CoAuthoredBy {
407 c.Options.Attribution.TrailerStyle = TrailerStyleCoAuthoredBy
408 } else {
409 c.Options.Attribution.TrailerStyle = TrailerStyleNone
410 }
411 } else {
412 c.Options.Attribution.TrailerStyle = TrailerStyleAssistedBy
413 }
414 }
415 c.Options.InitializeAs = cmp.Or(c.Options.InitializeAs, defaultInitializeAs)
416}
417
418// applyLSPDefaults applies default values from powernap to LSP configurations
419func (c *Config) applyLSPDefaults() {
420 // Get powernap's default configuration
421 configManager := powernapConfig.NewManager()
422 configManager.LoadDefaults()
423
424 // Apply defaults to each LSP configuration
425 for name, cfg := range c.LSP {
426 // Try to get defaults from powernap based on name or command name.
427 base, ok := configManager.GetServer(name)
428 if !ok {
429 base, ok = configManager.GetServer(cfg.Command)
430 if !ok {
431 continue
432 }
433 }
434 if cfg.Options == nil {
435 cfg.Options = base.Settings
436 }
437 if cfg.InitOptions == nil {
438 cfg.InitOptions = base.InitOptions
439 }
440 if len(cfg.FileTypes) == 0 {
441 cfg.FileTypes = base.FileTypes
442 }
443 if len(cfg.RootMarkers) == 0 {
444 cfg.RootMarkers = base.RootMarkers
445 }
446 cfg.Command = cmp.Or(cfg.Command, base.Command)
447 if len(cfg.Args) == 0 {
448 cfg.Args = base.Args
449 }
450 if len(cfg.Env) == 0 {
451 cfg.Env = base.Environment
452 }
453 // Update the config in the map
454 c.LSP[name] = cfg
455 }
456}
457
458func (c *Config) defaultModelSelection(knownProviders []catwalk.Provider) (largeModel SelectedModel, smallModel SelectedModel, err error) {
459 if len(knownProviders) == 0 && c.Providers.Len() == 0 {
460 err = fmt.Errorf("no providers configured, please configure at least one provider")
461 return largeModel, smallModel, err
462 }
463
464 // Use the first provider enabled based on the known providers order
465 // if no provider found that is known use the first provider configured
466 for _, p := range knownProviders {
467 providerConfig, ok := c.Providers.Get(string(p.ID))
468 if !ok || providerConfig.Disable {
469 continue
470 }
471 defaultLargeModel := c.GetModel(string(p.ID), p.DefaultLargeModelID)
472 if defaultLargeModel == nil {
473 err = fmt.Errorf("default large model %s not found for provider %s", p.DefaultLargeModelID, p.ID)
474 return largeModel, smallModel, err
475 }
476 largeModel = SelectedModel{
477 Provider: string(p.ID),
478 Model: defaultLargeModel.ID,
479 MaxTokens: defaultLargeModel.DefaultMaxTokens,
480 ReasoningEffort: defaultLargeModel.DefaultReasoningEffort,
481 }
482
483 defaultSmallModel := c.GetModel(string(p.ID), p.DefaultSmallModelID)
484 if defaultSmallModel == nil {
485 err = fmt.Errorf("default small model %s not found for provider %s", p.DefaultSmallModelID, p.ID)
486 return largeModel, smallModel, err
487 }
488 smallModel = SelectedModel{
489 Provider: string(p.ID),
490 Model: defaultSmallModel.ID,
491 MaxTokens: defaultSmallModel.DefaultMaxTokens,
492 ReasoningEffort: defaultSmallModel.DefaultReasoningEffort,
493 }
494 return largeModel, smallModel, err
495 }
496
497 enabledProviders := c.EnabledProviders()
498 slices.SortFunc(enabledProviders, func(a, b ProviderConfig) int {
499 return strings.Compare(a.ID, b.ID)
500 })
501
502 if len(enabledProviders) == 0 {
503 err = fmt.Errorf("no providers configured, please configure at least one provider")
504 return largeModel, smallModel, err
505 }
506
507 providerConfig := enabledProviders[0]
508 if len(providerConfig.Models) == 0 {
509 err = fmt.Errorf("provider %s has no models configured", providerConfig.ID)
510 return largeModel, smallModel, err
511 }
512 defaultLargeModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
513 largeModel = SelectedModel{
514 Provider: providerConfig.ID,
515 Model: defaultLargeModel.ID,
516 MaxTokens: defaultLargeModel.DefaultMaxTokens,
517 }
518 defaultSmallModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
519 smallModel = SelectedModel{
520 Provider: providerConfig.ID,
521 Model: defaultSmallModel.ID,
522 MaxTokens: defaultSmallModel.DefaultMaxTokens,
523 }
524 return largeModel, smallModel, err
525}
526
527func (c *Config) configureSelectedModels(knownProviders []catwalk.Provider) error {
528 defaultLarge, defaultSmall, err := c.defaultModelSelection(knownProviders)
529 if err != nil {
530 return fmt.Errorf("failed to select default models: %w", err)
531 }
532 large, small := defaultLarge, defaultSmall
533
534 largeModelSelected, largeModelConfigured := c.Models[SelectedModelTypeLarge]
535 if largeModelConfigured {
536 if largeModelSelected.Model != "" {
537 large.Model = largeModelSelected.Model
538 }
539 if largeModelSelected.Provider != "" {
540 large.Provider = largeModelSelected.Provider
541 }
542 model := c.GetModel(large.Provider, large.Model)
543 if model == nil {
544 large = defaultLarge
545 // override the model type to large
546 err := c.UpdatePreferredModel(SelectedModelTypeLarge, large)
547 if err != nil {
548 return fmt.Errorf("failed to update preferred large model: %w", err)
549 }
550 } else {
551 if largeModelSelected.MaxTokens > 0 {
552 large.MaxTokens = largeModelSelected.MaxTokens
553 } else {
554 large.MaxTokens = model.DefaultMaxTokens
555 }
556 if largeModelSelected.ReasoningEffort != "" {
557 large.ReasoningEffort = largeModelSelected.ReasoningEffort
558 }
559 large.Think = largeModelSelected.Think
560 if largeModelSelected.Temperature != nil {
561 large.Temperature = largeModelSelected.Temperature
562 }
563 if largeModelSelected.TopP != nil {
564 large.TopP = largeModelSelected.TopP
565 }
566 if largeModelSelected.TopK != nil {
567 large.TopK = largeModelSelected.TopK
568 }
569 if largeModelSelected.FrequencyPenalty != nil {
570 large.FrequencyPenalty = largeModelSelected.FrequencyPenalty
571 }
572 if largeModelSelected.PresencePenalty != nil {
573 large.PresencePenalty = largeModelSelected.PresencePenalty
574 }
575 }
576 }
577 smallModelSelected, smallModelConfigured := c.Models[SelectedModelTypeSmall]
578 if smallModelConfigured {
579 if smallModelSelected.Model != "" {
580 small.Model = smallModelSelected.Model
581 }
582 if smallModelSelected.Provider != "" {
583 small.Provider = smallModelSelected.Provider
584 }
585
586 model := c.GetModel(small.Provider, small.Model)
587 if model == nil {
588 small = defaultSmall
589 // override the model type to small
590 err := c.UpdatePreferredModel(SelectedModelTypeSmall, small)
591 if err != nil {
592 return fmt.Errorf("failed to update preferred small model: %w", err)
593 }
594 } else {
595 if smallModelSelected.MaxTokens > 0 {
596 small.MaxTokens = smallModelSelected.MaxTokens
597 } else {
598 small.MaxTokens = model.DefaultMaxTokens
599 }
600 if smallModelSelected.ReasoningEffort != "" {
601 small.ReasoningEffort = smallModelSelected.ReasoningEffort
602 }
603 if smallModelSelected.Temperature != nil {
604 small.Temperature = smallModelSelected.Temperature
605 }
606 if smallModelSelected.TopP != nil {
607 small.TopP = smallModelSelected.TopP
608 }
609 if smallModelSelected.TopK != nil {
610 small.TopK = smallModelSelected.TopK
611 }
612 if smallModelSelected.FrequencyPenalty != nil {
613 small.FrequencyPenalty = smallModelSelected.FrequencyPenalty
614 }
615 if smallModelSelected.PresencePenalty != nil {
616 small.PresencePenalty = smallModelSelected.PresencePenalty
617 }
618 small.Think = smallModelSelected.Think
619 }
620 }
621 c.Models[SelectedModelTypeLarge] = large
622 c.Models[SelectedModelTypeSmall] = small
623 return nil
624}
625
626// lookupConfigs searches config files recursively from CWD up to FS root
627func lookupConfigs(cwd string) []string {
628 // prepend default config paths
629 configPaths := []string{
630 GlobalConfig(),
631 GlobalConfigData(),
632 }
633
634 configNames := []string{appName + ".json", "." + appName + ".json"}
635
636 foundConfigs, err := fsext.Lookup(cwd, configNames...)
637 if err != nil {
638 // returns at least default configs
639 return configPaths
640 }
641
642 // reverse order so last config has more priority
643 slices.Reverse(foundConfigs)
644
645 return append(configPaths, foundConfigs...)
646}
647
648func loadFromConfigPaths(configPaths []string) (*Config, error) {
649 var configs [][]byte
650
651 for _, path := range configPaths {
652 data, err := os.ReadFile(path)
653 if err != nil {
654 if os.IsNotExist(err) {
655 continue
656 }
657 return nil, fmt.Errorf("failed to open config file %s: %w", path, err)
658 }
659 if len(data) == 0 {
660 continue
661 }
662 configs = append(configs, data)
663 }
664
665 return loadFromBytes(configs)
666}
667
668func loadFromBytes(configs [][]byte) (*Config, error) {
669 if len(configs) == 0 {
670 return &Config{}, nil
671 }
672
673 data, err := jsons.Merge(configs)
674 if err != nil {
675 return nil, err
676 }
677 var config Config
678 if err := json.Unmarshal(data, &config); err != nil {
679 return nil, err
680 }
681 return &config, nil
682}
683
684func hasAWSCredentials(env env.Env) bool {
685 if env.Get("AWS_BEARER_TOKEN_BEDROCK") != "" {
686 return true
687 }
688
689 if env.Get("AWS_ACCESS_KEY_ID") != "" && env.Get("AWS_SECRET_ACCESS_KEY") != "" {
690 return true
691 }
692
693 if env.Get("AWS_PROFILE") != "" || env.Get("AWS_DEFAULT_PROFILE") != "" {
694 return true
695 }
696
697 if env.Get("AWS_REGION") != "" || env.Get("AWS_DEFAULT_REGION") != "" {
698 return true
699 }
700
701 if env.Get("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") != "" ||
702 env.Get("AWS_CONTAINER_CREDENTIALS_FULL_URI") != "" {
703 return true
704 }
705
706 if _, err := os.Stat(filepath.Join(home.Dir(), ".aws/credentials")); err == nil && !testing.Testing() {
707 return true
708 }
709
710 return false
711}
712
713// GlobalConfig returns the global configuration file path for the application.
714func GlobalConfig() string {
715 if crushGlobal := os.Getenv("CRUSH_GLOBAL_CONFIG"); crushGlobal != "" {
716 return filepath.Join(crushGlobal, fmt.Sprintf("%s.json", appName))
717 }
718 if xdgConfigHome := os.Getenv("XDG_CONFIG_HOME"); xdgConfigHome != "" {
719 return filepath.Join(xdgConfigHome, appName, fmt.Sprintf("%s.json", appName))
720 }
721 return filepath.Join(home.Dir(), ".config", appName, fmt.Sprintf("%s.json", appName))
722}
723
724// GlobalConfigData returns the path to the main data directory for the application.
725// this config is used when the app overrides configurations instead of updating the global config.
726func GlobalConfigData() string {
727 if crushData := os.Getenv("CRUSH_GLOBAL_DATA"); crushData != "" {
728 return filepath.Join(crushData, fmt.Sprintf("%s.json", appName))
729 }
730 if xdgDataHome := os.Getenv("XDG_DATA_HOME"); xdgDataHome != "" {
731 return filepath.Join(xdgDataHome, appName, fmt.Sprintf("%s.json", appName))
732 }
733
734 // return the path to the main data directory
735 // for windows, it should be in `%LOCALAPPDATA%/crush/`
736 // for linux and macOS, it should be in `$HOME/.local/share/crush/`
737 if runtime.GOOS == "windows" {
738 localAppData := cmp.Or(
739 os.Getenv("LOCALAPPDATA"),
740 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
741 )
742 return filepath.Join(localAppData, appName, fmt.Sprintf("%s.json", appName))
743 }
744
745 return filepath.Join(home.Dir(), ".local", "share", appName, fmt.Sprintf("%s.json", appName))
746}
747
748func assignIfNil[T any](ptr **T, val T) {
749 if *ptr == nil {
750 *ptr = &val
751 }
752}
753
754func isInsideWorktree() bool {
755 bts, err := exec.CommandContext(
756 context.Background(),
757 "git", "rev-parse",
758 "--is-inside-work-tree",
759 ).CombinedOutput()
760 return err == nil && strings.TrimSpace(string(bts)) == "true"
761}
762
763// GlobalSkillsDirs returns the default directories for Agent Skills.
764// Skills in these directories are auto-discovered and their files can be read
765// without permission prompts.
766func GlobalSkillsDirs() []string {
767 if crushSkills := os.Getenv("CRUSH_SKILLS_DIR"); crushSkills != "" {
768 return []string{crushSkills}
769 }
770
771 // Determine the base config directory.
772 var configBase string
773 if xdgConfigHome := os.Getenv("XDG_CONFIG_HOME"); xdgConfigHome != "" {
774 configBase = xdgConfigHome
775 } else if runtime.GOOS == "windows" {
776 configBase = cmp.Or(
777 os.Getenv("LOCALAPPDATA"),
778 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
779 )
780 } else {
781 configBase = filepath.Join(home.Dir(), ".config")
782 }
783
784 return []string{
785 filepath.Join(configBase, appName, "skills"),
786 filepath.Join(configBase, "agents", "skills"),
787 }
788}
789
790func isAppleTerminal() bool { return os.Getenv("TERM_PROGRAM") == "Apple_Terminal" }