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 if providerConfig.Name == "" {
282 providerConfig.Name = id // Use ID as name if not set
283 }
284 // default to OpenAI if not set
285 if providerConfig.Type == "" {
286 providerConfig.Type = catwalk.TypeOpenAICompat
287 }
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 if c.Options.InitializeAs == "" {
416 c.Options.InitializeAs = defaultInitializeAs
417 }
418}
419
420// applyLSPDefaults applies default values from powernap to LSP configurations
421func (c *Config) applyLSPDefaults() {
422 // Get powernap's default configuration
423 configManager := powernapConfig.NewManager()
424 configManager.LoadDefaults()
425
426 // Apply defaults to each LSP configuration
427 for name, cfg := range c.LSP {
428 // Try to get defaults from powernap based on name or command name.
429 base, ok := configManager.GetServer(name)
430 if !ok {
431 base, ok = configManager.GetServer(cfg.Command)
432 if !ok {
433 continue
434 }
435 }
436 if cfg.Options == nil {
437 cfg.Options = base.Settings
438 }
439 if cfg.InitOptions == nil {
440 cfg.InitOptions = base.InitOptions
441 }
442 if len(cfg.FileTypes) == 0 {
443 cfg.FileTypes = base.FileTypes
444 }
445 if len(cfg.RootMarkers) == 0 {
446 cfg.RootMarkers = base.RootMarkers
447 }
448 if cfg.Command == "" {
449 cfg.Command = base.Command
450 }
451 if len(cfg.Args) == 0 {
452 cfg.Args = base.Args
453 }
454 if len(cfg.Env) == 0 {
455 cfg.Env = base.Environment
456 }
457 // Update the config in the map
458 c.LSP[name] = cfg
459 }
460}
461
462func (c *Config) defaultModelSelection(knownProviders []catwalk.Provider) (largeModel SelectedModel, smallModel SelectedModel, err error) {
463 if len(knownProviders) == 0 && c.Providers.Len() == 0 {
464 err = fmt.Errorf("no providers configured, please configure at least one provider")
465 return largeModel, smallModel, err
466 }
467
468 // Use the first provider enabled based on the known providers order
469 // if no provider found that is known use the first provider configured
470 for _, p := range knownProviders {
471 providerConfig, ok := c.Providers.Get(string(p.ID))
472 if !ok || providerConfig.Disable {
473 continue
474 }
475 defaultLargeModel := c.GetModel(string(p.ID), p.DefaultLargeModelID)
476 if defaultLargeModel == nil {
477 err = fmt.Errorf("default large model %s not found for provider %s", p.DefaultLargeModelID, p.ID)
478 return largeModel, smallModel, err
479 }
480 largeModel = SelectedModel{
481 Provider: string(p.ID),
482 Model: defaultLargeModel.ID,
483 MaxTokens: defaultLargeModel.DefaultMaxTokens,
484 ReasoningEffort: defaultLargeModel.DefaultReasoningEffort,
485 }
486
487 defaultSmallModel := c.GetModel(string(p.ID), p.DefaultSmallModelID)
488 if defaultSmallModel == nil {
489 err = fmt.Errorf("default small model %s not found for provider %s", p.DefaultSmallModelID, p.ID)
490 return largeModel, smallModel, err
491 }
492 smallModel = SelectedModel{
493 Provider: string(p.ID),
494 Model: defaultSmallModel.ID,
495 MaxTokens: defaultSmallModel.DefaultMaxTokens,
496 ReasoningEffort: defaultSmallModel.DefaultReasoningEffort,
497 }
498 return largeModel, smallModel, err
499 }
500
501 enabledProviders := c.EnabledProviders()
502 slices.SortFunc(enabledProviders, func(a, b ProviderConfig) int {
503 return strings.Compare(a.ID, b.ID)
504 })
505
506 if len(enabledProviders) == 0 {
507 err = fmt.Errorf("no providers configured, please configure at least one provider")
508 return largeModel, smallModel, err
509 }
510
511 providerConfig := enabledProviders[0]
512 if len(providerConfig.Models) == 0 {
513 err = fmt.Errorf("provider %s has no models configured", providerConfig.ID)
514 return largeModel, smallModel, err
515 }
516 defaultLargeModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
517 largeModel = SelectedModel{
518 Provider: providerConfig.ID,
519 Model: defaultLargeModel.ID,
520 MaxTokens: defaultLargeModel.DefaultMaxTokens,
521 }
522 defaultSmallModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
523 smallModel = SelectedModel{
524 Provider: providerConfig.ID,
525 Model: defaultSmallModel.ID,
526 MaxTokens: defaultSmallModel.DefaultMaxTokens,
527 }
528 return largeModel, smallModel, err
529}
530
531func (c *Config) configureSelectedModels(knownProviders []catwalk.Provider) error {
532 defaultLarge, defaultSmall, err := c.defaultModelSelection(knownProviders)
533 if err != nil {
534 return fmt.Errorf("failed to select default models: %w", err)
535 }
536 large, small := defaultLarge, defaultSmall
537
538 largeModelSelected, largeModelConfigured := c.Models[SelectedModelTypeLarge]
539 if largeModelConfigured {
540 if largeModelSelected.Model != "" {
541 large.Model = largeModelSelected.Model
542 }
543 if largeModelSelected.Provider != "" {
544 large.Provider = largeModelSelected.Provider
545 }
546 model := c.GetModel(large.Provider, large.Model)
547 if model == nil {
548 large = defaultLarge
549 // override the model type to large
550 err := c.UpdatePreferredModel(SelectedModelTypeLarge, large)
551 if err != nil {
552 return fmt.Errorf("failed to update preferred large model: %w", err)
553 }
554 } else {
555 if largeModelSelected.MaxTokens > 0 {
556 large.MaxTokens = largeModelSelected.MaxTokens
557 } else {
558 large.MaxTokens = model.DefaultMaxTokens
559 }
560 if largeModelSelected.ReasoningEffort != "" {
561 large.ReasoningEffort = largeModelSelected.ReasoningEffort
562 }
563 large.Think = largeModelSelected.Think
564 if largeModelSelected.Temperature != nil {
565 large.Temperature = largeModelSelected.Temperature
566 }
567 if largeModelSelected.TopP != nil {
568 large.TopP = largeModelSelected.TopP
569 }
570 if largeModelSelected.TopK != nil {
571 large.TopK = largeModelSelected.TopK
572 }
573 if largeModelSelected.FrequencyPenalty != nil {
574 large.FrequencyPenalty = largeModelSelected.FrequencyPenalty
575 }
576 if largeModelSelected.PresencePenalty != nil {
577 large.PresencePenalty = largeModelSelected.PresencePenalty
578 }
579 }
580 }
581 smallModelSelected, smallModelConfigured := c.Models[SelectedModelTypeSmall]
582 if smallModelConfigured {
583 if smallModelSelected.Model != "" {
584 small.Model = smallModelSelected.Model
585 }
586 if smallModelSelected.Provider != "" {
587 small.Provider = smallModelSelected.Provider
588 }
589
590 model := c.GetModel(small.Provider, small.Model)
591 if model == nil {
592 small = defaultSmall
593 // override the model type to small
594 err := c.UpdatePreferredModel(SelectedModelTypeSmall, small)
595 if err != nil {
596 return fmt.Errorf("failed to update preferred small model: %w", err)
597 }
598 } else {
599 if smallModelSelected.MaxTokens > 0 {
600 small.MaxTokens = smallModelSelected.MaxTokens
601 } else {
602 small.MaxTokens = model.DefaultMaxTokens
603 }
604 if smallModelSelected.ReasoningEffort != "" {
605 small.ReasoningEffort = smallModelSelected.ReasoningEffort
606 }
607 if smallModelSelected.Temperature != nil {
608 small.Temperature = smallModelSelected.Temperature
609 }
610 if smallModelSelected.TopP != nil {
611 small.TopP = smallModelSelected.TopP
612 }
613 if smallModelSelected.TopK != nil {
614 small.TopK = smallModelSelected.TopK
615 }
616 if smallModelSelected.FrequencyPenalty != nil {
617 small.FrequencyPenalty = smallModelSelected.FrequencyPenalty
618 }
619 if smallModelSelected.PresencePenalty != nil {
620 small.PresencePenalty = smallModelSelected.PresencePenalty
621 }
622 small.Think = smallModelSelected.Think
623 }
624 }
625 c.Models[SelectedModelTypeLarge] = large
626 c.Models[SelectedModelTypeSmall] = small
627 return nil
628}
629
630// lookupConfigs searches config files recursively from CWD up to FS root
631func lookupConfigs(cwd string) []string {
632 // prepend default config paths
633 configPaths := []string{
634 GlobalConfig(),
635 GlobalConfigData(),
636 }
637
638 configNames := []string{appName + ".json", "." + appName + ".json"}
639
640 foundConfigs, err := fsext.Lookup(cwd, configNames...)
641 if err != nil {
642 // returns at least default configs
643 return configPaths
644 }
645
646 // reverse order so last config has more priority
647 slices.Reverse(foundConfigs)
648
649 return append(configPaths, foundConfigs...)
650}
651
652func loadFromConfigPaths(configPaths []string) (*Config, error) {
653 var configs [][]byte
654
655 for _, path := range configPaths {
656 data, err := os.ReadFile(path)
657 if err != nil {
658 if os.IsNotExist(err) {
659 continue
660 }
661 return nil, fmt.Errorf("failed to open config file %s: %w", path, err)
662 }
663 if len(data) == 0 {
664 continue
665 }
666 configs = append(configs, data)
667 }
668
669 return loadFromBytes(configs)
670}
671
672func loadFromBytes(configs [][]byte) (*Config, error) {
673 if len(configs) == 0 {
674 return &Config{}, nil
675 }
676
677 data, err := jsons.Merge(configs)
678 if err != nil {
679 return nil, err
680 }
681 var config Config
682 if err := json.Unmarshal(data, &config); err != nil {
683 return nil, err
684 }
685 return &config, nil
686}
687
688func hasVertexCredentials(env env.Env) bool {
689 hasProject := env.Get("VERTEXAI_PROJECT") != ""
690 hasLocation := env.Get("VERTEXAI_LOCATION") != ""
691 return hasProject && hasLocation
692}
693
694func hasAWSCredentials(env env.Env) bool {
695 if env.Get("AWS_BEARER_TOKEN_BEDROCK") != "" {
696 return true
697 }
698
699 if env.Get("AWS_ACCESS_KEY_ID") != "" && env.Get("AWS_SECRET_ACCESS_KEY") != "" {
700 return true
701 }
702
703 if env.Get("AWS_PROFILE") != "" || env.Get("AWS_DEFAULT_PROFILE") != "" {
704 return true
705 }
706
707 if env.Get("AWS_REGION") != "" || env.Get("AWS_DEFAULT_REGION") != "" {
708 return true
709 }
710
711 if env.Get("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") != "" ||
712 env.Get("AWS_CONTAINER_CREDENTIALS_FULL_URI") != "" {
713 return true
714 }
715
716 if _, err := os.Stat(filepath.Join(home.Dir(), ".aws/credentials")); err == nil && !testing.Testing() {
717 return true
718 }
719
720 return false
721}
722
723// GlobalConfig returns the global configuration file path for the application.
724func GlobalConfig() string {
725 if crushGlobal := os.Getenv("CRUSH_GLOBAL_CONFIG"); crushGlobal != "" {
726 return filepath.Join(crushGlobal, fmt.Sprintf("%s.json", appName))
727 }
728 if xdgConfigHome := os.Getenv("XDG_CONFIG_HOME"); xdgConfigHome != "" {
729 return filepath.Join(xdgConfigHome, appName, fmt.Sprintf("%s.json", appName))
730 }
731 return filepath.Join(home.Dir(), ".config", appName, fmt.Sprintf("%s.json", appName))
732}
733
734// GlobalConfigData returns the path to the main data directory for the application.
735// this config is used when the app overrides configurations instead of updating the global config.
736func GlobalConfigData() string {
737 if crushData := os.Getenv("CRUSH_GLOBAL_DATA"); crushData != "" {
738 return filepath.Join(crushData, fmt.Sprintf("%s.json", appName))
739 }
740 if xdgDataHome := os.Getenv("XDG_DATA_HOME"); xdgDataHome != "" {
741 return filepath.Join(xdgDataHome, appName, fmt.Sprintf("%s.json", appName))
742 }
743
744 // return the path to the main data directory
745 // for windows, it should be in `%LOCALAPPDATA%/crush/`
746 // for linux and macOS, it should be in `$HOME/.local/share/crush/`
747 if runtime.GOOS == "windows" {
748 localAppData := cmp.Or(
749 os.Getenv("LOCALAPPDATA"),
750 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
751 )
752 return filepath.Join(localAppData, appName, fmt.Sprintf("%s.json", appName))
753 }
754
755 return filepath.Join(home.Dir(), ".local", "share", appName, fmt.Sprintf("%s.json", appName))
756}
757
758func assignIfNil[T any](ptr **T, val T) {
759 if *ptr == nil {
760 *ptr = &val
761 }
762}
763
764func isInsideWorktree() bool {
765 bts, err := exec.CommandContext(
766 context.Background(),
767 "git", "rev-parse",
768 "--is-inside-work-tree",
769 ).CombinedOutput()
770 return err == nil && strings.TrimSpace(string(bts)) == "true"
771}
772
773// GlobalSkillsDirs returns the default directories for Agent Skills.
774// Skills in these directories are auto-discovered and their files can be read
775// without permission prompts.
776func GlobalSkillsDirs() []string {
777 if crushSkills := os.Getenv("CRUSH_SKILLS_DIR"); crushSkills != "" {
778 return []string{crushSkills}
779 }
780
781 // Determine the base config directory.
782 var configBase string
783 if xdgConfigHome := os.Getenv("XDG_CONFIG_HOME"); xdgConfigHome != "" {
784 configBase = xdgConfigHome
785 } else if runtime.GOOS == "windows" {
786 configBase = cmp.Or(
787 os.Getenv("LOCALAPPDATA"),
788 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
789 )
790 } else {
791 configBase = filepath.Join(home.Dir(), ".config")
792 }
793
794 return []string{
795 filepath.Join(configBase, appName, "skills"),
796 filepath.Join(configBase, "agents", "skills"),
797 }
798}
799
800func isAppleTerminal() bool { return os.Getenv("TERM_PROGRAM") == "Apple_Terminal" }