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 "regexp"
14 "runtime"
15 "slices"
16 "strconv"
17 "strings"
18 "testing"
19
20 "charm.land/catwalk/pkg/catwalk"
21 "github.com/charmbracelet/crush/internal/agent/hyper"
22 "github.com/charmbracelet/crush/internal/csync"
23 "github.com/charmbracelet/crush/internal/env"
24 "github.com/charmbracelet/crush/internal/fsext"
25 "github.com/charmbracelet/crush/internal/home"
26 powernapConfig "github.com/charmbracelet/x/powernap/pkg/config"
27 "github.com/qjebbs/go-jsons"
28)
29
30const defaultCatwalkURL = "https://catwalk.charm.land"
31
32// Load loads the configuration from the default paths and returns a
33// ConfigStore that owns both the pure-data Config and all runtime state.
34func Load(workingDir, dataDir string, debug bool) (*ConfigStore, error) {
35 configPaths := lookupConfigs(workingDir)
36
37 cfg, loadedPaths, err := loadFromConfigPaths(configPaths)
38 if err != nil {
39 return nil, fmt.Errorf("failed to load config from paths %v: %w", configPaths, err)
40 }
41
42 cfg.setDefaults(workingDir, dataDir)
43
44 store := &ConfigStore{
45 config: cfg,
46 workingDir: workingDir,
47 globalDataPath: GlobalConfigData(),
48 workspacePath: filepath.Join(cfg.Options.DataDirectory, fmt.Sprintf("%s.json", appName)),
49 loadedPaths: loadedPaths,
50 }
51
52 if debug {
53 cfg.Options.Debug = true
54 }
55
56 // Load workspace config last so it has highest priority.
57 if wsData, err := os.ReadFile(store.workspacePath); err == nil && len(wsData) > 0 {
58 merged, mergeErr := loadFromBytes(append([][]byte{mustMarshalConfig(cfg)}, wsData))
59 if mergeErr == nil {
60 // Preserve defaults that setDefaults already applied.
61 dataDir := cfg.Options.DataDirectory
62 *cfg = *merged
63 cfg.setDefaults(workingDir, dataDir)
64 store.config = cfg
65 store.loadedPaths = append(store.loadedPaths, store.workspacePath)
66 }
67 }
68
69 // Validate hooks after all config merging is complete so workspace
70 // hooks also get their matcher regexes compiled.
71 if err := cfg.ValidateHooks(); err != nil {
72 return nil, fmt.Errorf("invalid hook configuration: %w", err)
73 }
74
75 if !isInsideWorktree() {
76 const depth = 2
77 const items = 100
78 slog.Warn("No git repository detected in working directory, will limit file walk operations", "depth", depth, "items", items)
79 assignIfNil(&cfg.Tools.Ls.MaxDepth, depth)
80 assignIfNil(&cfg.Tools.Ls.MaxItems, items)
81 assignIfNil(&cfg.Options.TUI.Completions.MaxDepth, depth)
82 assignIfNil(&cfg.Options.TUI.Completions.MaxItems, items)
83 }
84
85 if isAppleTerminal() {
86 slog.Warn("Detected Apple Terminal, enabling transparent mode")
87 assignIfNil(&cfg.Options.TUI.Transparent, true)
88 }
89
90 // Load known providers, this loads the config from catwalk
91 providers, err := Providers(cfg)
92 if err != nil {
93 return nil, err
94 }
95 store.knownProviders = providers
96
97 env := env.New()
98 // Configure providers
99 valueResolver := NewShellVariableResolver(env)
100 store.resolver = valueResolver
101
102 // Disable auto-reload during initial load to prevent nested calls from
103 // config-modifying operations inside configureProviders.
104 store.autoReloadDisabled = true
105 defer func() { store.autoReloadDisabled = false }()
106
107 if err := cfg.configureProviders(store, env, valueResolver, store.knownProviders); err != nil {
108 return nil, fmt.Errorf("failed to configure providers: %w", err)
109 }
110
111 if !cfg.IsConfigured() {
112 slog.Warn("No providers configured")
113 return store, nil
114 }
115
116 if err := configureSelectedModels(store, store.knownProviders, true); err != nil {
117 return nil, fmt.Errorf("failed to configure selected models: %w", err)
118 }
119 store.SetupAgents()
120
121 // Capture initial staleness snapshot
122 store.captureStalenessSnapshot(loadedPaths)
123
124 return store, nil
125}
126
127// mustMarshalConfig marshals the config to JSON bytes, returning empty JSON on
128// error.
129func mustMarshalConfig(cfg *Config) []byte {
130 data, err := json.Marshal(cfg)
131 if err != nil {
132 return []byte("{}")
133 }
134 return data
135}
136
137func PushPopCrushEnv() func() {
138 var found []string
139 for _, ev := range os.Environ() {
140 if strings.HasPrefix(ev, "CRUSH_") {
141 pair := strings.SplitN(ev, "=", 2)
142 if len(pair) != 2 {
143 continue
144 }
145 found = append(found, strings.TrimPrefix(pair[0], "CRUSH_"))
146 }
147 }
148 backups := make(map[string]string)
149 for _, ev := range found {
150 backups[ev] = os.Getenv(ev)
151 }
152
153 for _, ev := range found {
154 os.Setenv(ev, os.Getenv("CRUSH_"+ev))
155 }
156
157 restore := func() {
158 for k, v := range backups {
159 os.Setenv(k, v)
160 }
161 }
162 return restore
163}
164
165func (c *Config) configureProviders(store *ConfigStore, env env.Env, resolver VariableResolver, knownProviders []catwalk.Provider) error {
166 knownProviderNames := make(map[string]bool)
167 restore := PushPopCrushEnv()
168 defer restore()
169
170 // When disable_default_providers is enabled, skip all default/embedded
171 // providers entirely. Users must fully specify any providers they want.
172 // We skip to the custom provider validation loop which handles all
173 // user-configured providers uniformly.
174 if c.Options.DisableDefaultProviders {
175 knownProviders = nil
176 }
177
178 for _, p := range knownProviders {
179 knownProviderNames[string(p.ID)] = true
180 config, configExists := c.Providers.Get(string(p.ID))
181 // if the user configured a known provider we need to allow it to override a couple of parameters
182 if configExists {
183 if config.BaseURL != "" {
184 p.APIEndpoint = config.BaseURL
185 }
186 if config.APIKey != "" {
187 p.APIKey = config.APIKey
188 }
189 if len(config.Models) > 0 {
190 models := []catwalk.Model{}
191 seen := make(map[string]bool)
192
193 for _, model := range config.Models {
194 if seen[model.ID] {
195 continue
196 }
197 seen[model.ID] = true
198 if model.Name == "" {
199 model.Name = model.ID
200 }
201 models = append(models, model)
202 }
203 for _, model := range p.Models {
204 if seen[model.ID] {
205 continue
206 }
207 seen[model.ID] = true
208 if model.Name == "" {
209 model.Name = model.ID
210 }
211 models = append(models, model)
212 }
213
214 p.Models = models
215 }
216 }
217
218 headers := map[string]string{}
219 if len(p.DefaultHeaders) > 0 {
220 maps.Copy(headers, p.DefaultHeaders)
221 }
222 if len(config.ExtraHeaders) > 0 {
223 maps.Copy(headers, config.ExtraHeaders)
224 }
225 // Intentional divergence from MCP env/headers/args/url resolution:
226 // provider headers that fail to resolve log and keep their literal
227 // template so providers with optional, env-gated headers still
228 // load on hosts where those vars are unset. Changing this to a
229 // hard error would break those configs. See PLAN.md "Design
230 // decisions" item 4 for the full rationale.
231 for k, v := range headers {
232 resolved, err := resolver.ResolveValue(v)
233 if err != nil {
234 slog.Error("Could not resolve provider header", "err", err.Error())
235 continue
236 }
237 headers[k] = resolved
238 }
239 prepared := ProviderConfig{
240 ID: string(p.ID),
241 Name: p.Name,
242 BaseURL: p.APIEndpoint,
243 APIKey: p.APIKey,
244 APIKeyTemplate: p.APIKey, // Store original template for re-resolution
245 OAuthToken: config.OAuthToken,
246 Type: p.Type,
247 Disable: config.Disable,
248 SystemPromptPrefix: config.SystemPromptPrefix,
249 ExtraHeaders: headers,
250 ExtraBody: config.ExtraBody,
251 ExtraParams: make(map[string]string),
252 Models: p.Models,
253 }
254
255 switch {
256 case p.ID == catwalk.InferenceProviderAnthropic && config.OAuthToken != nil:
257 // Claude Code subscription is not supported anymore. Remove to show onboarding.
258 if !store.reloadInProgress {
259 store.RemoveConfigField(ScopeGlobal, "providers.anthropic")
260 }
261 c.Providers.Del(string(p.ID))
262 continue
263 case p.ID == catwalk.InferenceProviderCopilot && config.OAuthToken != nil:
264 prepared.SetupGitHubCopilot()
265 }
266
267 switch p.ID {
268 // Handle specific providers that require additional configuration
269 case catwalk.InferenceProviderVertexAI:
270 var (
271 project = env.Get("VERTEXAI_PROJECT")
272 location = env.Get("VERTEXAI_LOCATION")
273 )
274 if project == "" || location == "" {
275 if configExists {
276 slog.Warn("Skipping Vertex AI provider due to missing credentials")
277 c.Providers.Del(string(p.ID))
278 }
279 continue
280 }
281 prepared.ExtraParams["project"] = project
282 prepared.ExtraParams["location"] = location
283 case catwalk.InferenceProviderAzure:
284 endpoint, err := resolver.ResolveValue(p.APIEndpoint)
285 if err != nil || endpoint == "" {
286 if configExists {
287 slog.Warn("Skipping Azure provider due to missing API endpoint", "provider", p.ID, "error", err)
288 c.Providers.Del(string(p.ID))
289 }
290 continue
291 }
292 prepared.BaseURL = endpoint
293 prepared.ExtraParams["apiVersion"] = env.Get("AZURE_OPENAI_API_VERSION")
294 case catwalk.InferenceProviderBedrock:
295 if !hasAWSCredentials(env) {
296 if configExists {
297 slog.Warn("Skipping Bedrock provider due to missing AWS credentials")
298 c.Providers.Del(string(p.ID))
299 }
300 continue
301 }
302 prepared.ExtraParams["region"] = env.Get("AWS_REGION")
303 if prepared.ExtraParams["region"] == "" {
304 prepared.ExtraParams["region"] = env.Get("AWS_DEFAULT_REGION")
305 }
306 for _, model := range p.Models {
307 if !strings.HasPrefix(model.ID, "anthropic.") {
308 return fmt.Errorf("bedrock provider only supports anthropic models for now, found: %s", model.ID)
309 }
310 }
311 case catwalk.InferenceProvider("hyper"):
312 if apiKey := env.Get("HYPER_API_KEY"); apiKey != "" {
313 prepared.APIKey = apiKey
314 prepared.APIKeyTemplate = apiKey
315 } else {
316 v, err := resolver.ResolveValue(p.APIKey)
317 if v == "" || err != nil {
318 if configExists {
319 slog.Warn("Skipping Hyper provider due to missing API key", "provider", p.ID)
320 c.Providers.Del(string(p.ID))
321 }
322 continue
323 }
324 }
325 default:
326 // if the provider api or endpoint are missing we skip them
327 v, err := resolver.ResolveValue(p.APIKey)
328 if v == "" || err != nil {
329 if configExists {
330 slog.Warn("Skipping provider due to missing API key", "provider", p.ID)
331 c.Providers.Del(string(p.ID))
332 }
333 continue
334 }
335 }
336 c.Providers.Set(string(p.ID), prepared)
337 }
338
339 // validate the custom providers
340 for id, providerConfig := range c.Providers.Seq2() {
341 if knownProviderNames[id] {
342 continue
343 }
344
345 // Make sure the provider ID is set
346 providerConfig.ID = id
347 providerConfig.Name = cmp.Or(providerConfig.Name, id) // Use ID as name if not set
348 // default to OpenAI if not set
349 providerConfig.Type = cmp.Or(providerConfig.Type, catwalk.TypeOpenAICompat)
350 if !slices.Contains(catwalk.KnownProviderTypes(), providerConfig.Type) && providerConfig.Type != hyper.Name {
351 slog.Warn("Skipping custom provider due to unsupported provider type", "provider", id)
352 c.Providers.Del(id)
353 continue
354 }
355
356 if providerConfig.Disable {
357 slog.Debug("Skipping custom provider due to disable flag", "provider", id)
358 c.Providers.Del(id)
359 continue
360 }
361 if providerConfig.APIKey == "" {
362 slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
363 }
364 if providerConfig.BaseURL == "" {
365 slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id)
366 c.Providers.Del(id)
367 continue
368 }
369 if len(providerConfig.Models) == 0 {
370 slog.Warn("Skipping custom provider because the provider has no models", "provider", id)
371 c.Providers.Del(id)
372 continue
373 }
374 apiKey, err := resolver.ResolveValue(providerConfig.APIKey)
375 if apiKey == "" || err != nil {
376 slog.Warn("Provider is missing API key, this might be OK for local providers", "provider", id)
377 }
378 baseURL, err := resolver.ResolveValue(providerConfig.BaseURL)
379 if baseURL == "" || err != nil {
380 slog.Warn("Skipping custom provider due to missing API endpoint", "provider", id, "error", err)
381 c.Providers.Del(id)
382 continue
383 }
384
385 for k, v := range providerConfig.ExtraHeaders {
386 resolved, err := resolver.ResolveValue(v)
387 if err != nil {
388 slog.Error("Could not resolve provider header", "err", err.Error())
389 continue
390 }
391 providerConfig.ExtraHeaders[k] = resolved
392 }
393
394 c.Providers.Set(id, providerConfig)
395 }
396
397 if c.Providers.Len() == 0 && c.Options.DisableDefaultProviders {
398 return fmt.Errorf("default providers are disabled and there are no custom providers are configured")
399 }
400
401 return nil
402}
403
404func (c *Config) setDefaults(workingDir, dataDir string) {
405 if c.Options == nil {
406 c.Options = &Options{}
407 }
408 if c.Options.TUI == nil {
409 c.Options.TUI = &TUIOptions{}
410 }
411 if dataDir != "" {
412 c.Options.DataDirectory = dataDir
413 } else if c.Options.DataDirectory == "" {
414 if path, ok := fsext.LookupClosest(workingDir, defaultDataDirectory); ok {
415 c.Options.DataDirectory = path
416 } else {
417 c.Options.DataDirectory = filepath.Join(workingDir, defaultDataDirectory)
418 }
419 }
420 if c.Providers == nil {
421 c.Providers = csync.NewMap[string, ProviderConfig]()
422 }
423 if c.Models == nil {
424 c.Models = make(map[SelectedModelType]SelectedModel)
425 }
426 if c.RecentModels == nil {
427 c.RecentModels = make(map[SelectedModelType][]SelectedModel)
428 }
429 if c.MCP == nil {
430 c.MCP = make(map[string]MCPConfig)
431 }
432 if c.LSP == nil {
433 c.LSP = make(map[string]LSPConfig)
434 }
435
436 // Apply defaults to LSP configurations
437 c.applyLSPDefaults()
438
439 // Add the default context paths if they are not already present
440 c.Options.ContextPaths = append(defaultContextPaths, c.Options.ContextPaths...)
441 slices.Sort(c.Options.ContextPaths)
442 c.Options.ContextPaths = slices.Compact(c.Options.ContextPaths)
443
444 // Add the default skills directories if not already present.
445 for _, dir := range GlobalSkillsDirs() {
446 if !slices.Contains(c.Options.SkillsPaths, dir) {
447 c.Options.SkillsPaths = append(c.Options.SkillsPaths, dir)
448 }
449 }
450
451 // Project specific skills dirs.
452 c.Options.SkillsPaths = append(c.Options.SkillsPaths, ProjectSkillsDir(workingDir)...)
453
454 if str, ok := os.LookupEnv("CRUSH_DISABLE_PROVIDER_AUTO_UPDATE"); ok {
455 c.Options.DisableProviderAutoUpdate, _ = strconv.ParseBool(str)
456 }
457
458 if str, ok := os.LookupEnv("CRUSH_DISABLE_DEFAULT_PROVIDERS"); ok {
459 c.Options.DisableDefaultProviders, _ = strconv.ParseBool(str)
460 }
461
462 if c.Options.Attribution == nil {
463 c.Options.Attribution = &Attribution{
464 TrailerStyle: TrailerStyleAssistedBy,
465 GeneratedWith: true,
466 }
467 } else if c.Options.Attribution.TrailerStyle == "" {
468 // Migrate deprecated co_authored_by or apply default
469 if c.Options.Attribution.CoAuthoredBy != nil {
470 if *c.Options.Attribution.CoAuthoredBy {
471 c.Options.Attribution.TrailerStyle = TrailerStyleCoAuthoredBy
472 } else {
473 c.Options.Attribution.TrailerStyle = TrailerStyleNone
474 }
475 } else {
476 c.Options.Attribution.TrailerStyle = TrailerStyleAssistedBy
477 }
478 }
479 c.Options.InitializeAs = cmp.Or(c.Options.InitializeAs, defaultInitializeAs)
480}
481
482// applyLSPDefaults applies default values from powernap to LSP configurations
483func (c *Config) applyLSPDefaults() {
484 // Get powernap's default configuration
485 configManager := powernapConfig.NewManager()
486 configManager.LoadDefaults()
487
488 // Apply defaults to each LSP configuration
489 for name, cfg := range c.LSP {
490 // Try to get defaults from powernap based on name or command name.
491 base, ok := configManager.GetServer(name)
492 if !ok {
493 base, ok = configManager.GetServer(cfg.Command)
494 if !ok {
495 continue
496 }
497 }
498 if cfg.Options == nil {
499 cfg.Options = base.Settings
500 }
501 if cfg.InitOptions == nil {
502 cfg.InitOptions = base.InitOptions
503 }
504 if len(cfg.FileTypes) == 0 {
505 cfg.FileTypes = base.FileTypes
506 }
507 if len(cfg.RootMarkers) == 0 {
508 cfg.RootMarkers = base.RootMarkers
509 }
510 cfg.Command = cmp.Or(cfg.Command, base.Command)
511 if len(cfg.Args) == 0 {
512 cfg.Args = base.Args
513 }
514 if len(cfg.Env) == 0 {
515 cfg.Env = base.Environment
516 }
517 // Update the config in the map
518 c.LSP[name] = cfg
519 }
520}
521
522func (c *Config) defaultModelSelection(knownProviders []catwalk.Provider) (largeModel SelectedModel, smallModel SelectedModel, err error) {
523 if len(knownProviders) == 0 && c.Providers.Len() == 0 {
524 err = fmt.Errorf("no providers configured, please configure at least one provider")
525 return largeModel, smallModel, err
526 }
527
528 // Use the first provider enabled based on the known providers order
529 // if no provider found that is known use the first provider configured
530 for _, p := range knownProviders {
531 providerConfig, ok := c.Providers.Get(string(p.ID))
532 if !ok || providerConfig.Disable {
533 continue
534 }
535 defaultLargeModel := c.GetModel(string(p.ID), p.DefaultLargeModelID)
536 if defaultLargeModel == nil {
537 err = fmt.Errorf("default large model %s not found for provider %s", p.DefaultLargeModelID, p.ID)
538 return largeModel, smallModel, err
539 }
540 largeModel = SelectedModel{
541 Provider: string(p.ID),
542 Model: defaultLargeModel.ID,
543 MaxTokens: defaultLargeModel.DefaultMaxTokens,
544 ReasoningEffort: defaultLargeModel.DefaultReasoningEffort,
545 }
546
547 defaultSmallModel := c.GetModel(string(p.ID), p.DefaultSmallModelID)
548 if defaultSmallModel == nil {
549 err = fmt.Errorf("default small model %s not found for provider %s", p.DefaultSmallModelID, p.ID)
550 return largeModel, smallModel, err
551 }
552 smallModel = SelectedModel{
553 Provider: string(p.ID),
554 Model: defaultSmallModel.ID,
555 MaxTokens: defaultSmallModel.DefaultMaxTokens,
556 ReasoningEffort: defaultSmallModel.DefaultReasoningEffort,
557 }
558 return largeModel, smallModel, err
559 }
560
561 enabledProviders := c.EnabledProviders()
562 slices.SortFunc(enabledProviders, func(a, b ProviderConfig) int {
563 return strings.Compare(a.ID, b.ID)
564 })
565
566 if len(enabledProviders) == 0 {
567 err = fmt.Errorf("no providers configured, please configure at least one provider")
568 return largeModel, smallModel, err
569 }
570
571 providerConfig := enabledProviders[0]
572 if len(providerConfig.Models) == 0 {
573 err = fmt.Errorf("provider %s has no models configured", providerConfig.ID)
574 return largeModel, smallModel, err
575 }
576 defaultLargeModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
577 largeModel = SelectedModel{
578 Provider: providerConfig.ID,
579 Model: defaultLargeModel.ID,
580 MaxTokens: defaultLargeModel.DefaultMaxTokens,
581 }
582 defaultSmallModel := c.GetModel(providerConfig.ID, providerConfig.Models[0].ID)
583 smallModel = SelectedModel{
584 Provider: providerConfig.ID,
585 Model: defaultSmallModel.ID,
586 MaxTokens: defaultSmallModel.DefaultMaxTokens,
587 }
588 return largeModel, smallModel, err
589}
590
591func configureSelectedModels(store *ConfigStore, knownProviders []catwalk.Provider, persist bool) error {
592 c := store.config
593 defaultLarge, defaultSmall, err := c.defaultModelSelection(knownProviders)
594 if err != nil {
595 return fmt.Errorf("failed to select default models: %w", err)
596 }
597 large, small := defaultLarge, defaultSmall
598
599 largeModelSelected, largeModelConfigured := c.Models[SelectedModelTypeLarge]
600 if largeModelConfigured {
601 if largeModelSelected.Model != "" {
602 large.Model = largeModelSelected.Model
603 }
604 if largeModelSelected.Provider != "" {
605 large.Provider = largeModelSelected.Provider
606 }
607 model := c.GetModel(large.Provider, large.Model)
608 if model == nil {
609 large = defaultLarge
610 if persist {
611 if err := store.UpdatePreferredModel(ScopeGlobal, SelectedModelTypeLarge, large); err != nil {
612 return fmt.Errorf("failed to update preferred large model: %w", err)
613 }
614 }
615 } else {
616 if largeModelSelected.MaxTokens > 0 {
617 large.MaxTokens = largeModelSelected.MaxTokens
618 } else {
619 large.MaxTokens = model.DefaultMaxTokens
620 }
621 if largeModelSelected.ReasoningEffort != "" {
622 large.ReasoningEffort = largeModelSelected.ReasoningEffort
623 }
624 large.Think = largeModelSelected.Think
625 if largeModelSelected.Temperature != nil {
626 large.Temperature = largeModelSelected.Temperature
627 }
628 if largeModelSelected.TopP != nil {
629 large.TopP = largeModelSelected.TopP
630 }
631 if largeModelSelected.TopK != nil {
632 large.TopK = largeModelSelected.TopK
633 }
634 if largeModelSelected.FrequencyPenalty != nil {
635 large.FrequencyPenalty = largeModelSelected.FrequencyPenalty
636 }
637 if largeModelSelected.PresencePenalty != nil {
638 large.PresencePenalty = largeModelSelected.PresencePenalty
639 }
640 }
641 }
642 smallModelSelected, smallModelConfigured := c.Models[SelectedModelTypeSmall]
643 if smallModelConfigured {
644 if smallModelSelected.Model != "" {
645 small.Model = smallModelSelected.Model
646 }
647 if smallModelSelected.Provider != "" {
648 small.Provider = smallModelSelected.Provider
649 }
650
651 model := c.GetModel(small.Provider, small.Model)
652 if model == nil {
653 small = defaultSmall
654 if persist {
655 if err := store.UpdatePreferredModel(ScopeGlobal, SelectedModelTypeSmall, small); err != nil {
656 return fmt.Errorf("failed to update preferred small model: %w", err)
657 }
658 }
659 } else {
660 if smallModelSelected.MaxTokens > 0 {
661 small.MaxTokens = smallModelSelected.MaxTokens
662 } else {
663 small.MaxTokens = model.DefaultMaxTokens
664 }
665 if smallModelSelected.ReasoningEffort != "" {
666 small.ReasoningEffort = smallModelSelected.ReasoningEffort
667 }
668 if smallModelSelected.Temperature != nil {
669 small.Temperature = smallModelSelected.Temperature
670 }
671 if smallModelSelected.TopP != nil {
672 small.TopP = smallModelSelected.TopP
673 }
674 if smallModelSelected.TopK != nil {
675 small.TopK = smallModelSelected.TopK
676 }
677 if smallModelSelected.FrequencyPenalty != nil {
678 small.FrequencyPenalty = smallModelSelected.FrequencyPenalty
679 }
680 if smallModelSelected.PresencePenalty != nil {
681 small.PresencePenalty = smallModelSelected.PresencePenalty
682 }
683 small.Think = smallModelSelected.Think
684 }
685 }
686 c.Models[SelectedModelTypeLarge] = large
687 c.Models[SelectedModelTypeSmall] = small
688 return nil
689}
690
691// lookupConfigs searches config files recursively from CWD up to FS root
692func lookupConfigs(cwd string) []string {
693 // prepend default config paths
694 configPaths := []string{
695 GlobalConfig(),
696 GlobalConfigData(),
697 }
698
699 configNames := []string{appName + ".json", "." + appName + ".json"}
700
701 foundConfigs, err := fsext.Lookup(cwd, configNames...)
702 if err != nil {
703 // returns at least default configs
704 return configPaths
705 }
706
707 // reverse order so last config has more priority
708 slices.Reverse(foundConfigs)
709
710 return append(configPaths, foundConfigs...)
711}
712
713func loadFromConfigPaths(configPaths []string) (*Config, []string, error) {
714 var configs [][]byte
715 var loaded []string
716
717 for _, path := range configPaths {
718 data, err := os.ReadFile(path)
719 if err != nil {
720 if os.IsNotExist(err) {
721 continue
722 }
723 return nil, nil, fmt.Errorf("failed to open config file %s: %w", path, err)
724 }
725 if len(data) == 0 {
726 continue
727 }
728 configs = append(configs, data)
729 loaded = append(loaded, path)
730 }
731
732 cfg, err := loadFromBytes(configs)
733 if err != nil {
734 return nil, nil, err
735 }
736 return cfg, loaded, nil
737}
738
739func loadFromBytes(configs [][]byte) (*Config, error) {
740 if len(configs) == 0 {
741 return &Config{}, nil
742 }
743
744 data, err := jsons.Merge(configs)
745 if err != nil {
746 return nil, err
747 }
748 var config Config
749 if err := json.Unmarshal(data, &config); err != nil {
750 return nil, err
751 }
752 return &config, nil
753}
754
755func hasAWSCredentials(env env.Env) bool {
756 if env.Get("AWS_BEARER_TOKEN_BEDROCK") != "" {
757 return true
758 }
759
760 if env.Get("AWS_ACCESS_KEY_ID") != "" && env.Get("AWS_SECRET_ACCESS_KEY") != "" {
761 return true
762 }
763
764 if env.Get("AWS_PROFILE") != "" || env.Get("AWS_DEFAULT_PROFILE") != "" {
765 return true
766 }
767
768 if env.Get("AWS_REGION") != "" || env.Get("AWS_DEFAULT_REGION") != "" {
769 return true
770 }
771
772 if env.Get("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") != "" ||
773 env.Get("AWS_CONTAINER_CREDENTIALS_FULL_URI") != "" {
774 return true
775 }
776
777 if _, err := os.Stat(filepath.Join(home.Dir(), ".aws/credentials")); err == nil && !testing.Testing() {
778 return true
779 }
780
781 return false
782}
783
784// GlobalConfig returns the global configuration file path for the application.
785func GlobalConfig() string {
786 if crushGlobal := os.Getenv("CRUSH_GLOBAL_CONFIG"); crushGlobal != "" {
787 return filepath.Join(crushGlobal, fmt.Sprintf("%s.json", appName))
788 }
789 return filepath.Join(home.Config(), appName, fmt.Sprintf("%s.json", appName))
790}
791
792// GlobalCacheDir returns the path to the global cache directory for the
793// application.
794func GlobalCacheDir() string {
795 if crushCache := os.Getenv("CRUSH_CACHE_DIR"); crushCache != "" {
796 return crushCache
797 }
798 if xdgCacheHome := os.Getenv("XDG_CACHE_HOME"); xdgCacheHome != "" {
799 return filepath.Join(xdgCacheHome, appName)
800 }
801 if runtime.GOOS == "windows" {
802 localAppData := cmp.Or(
803 os.Getenv("LOCALAPPDATA"),
804 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
805 )
806 return filepath.Join(localAppData, appName, "cache")
807 }
808 return filepath.Join(home.Dir(), ".cache", appName)
809}
810
811// GlobalConfigData returns the path to the main data directory for the application.
812// this config is used when the app overrides configurations instead of updating the global config.
813func GlobalConfigData() string {
814 if crushData := os.Getenv("CRUSH_GLOBAL_DATA"); crushData != "" {
815 return filepath.Join(crushData, fmt.Sprintf("%s.json", appName))
816 }
817 if xdgDataHome := os.Getenv("XDG_DATA_HOME"); xdgDataHome != "" {
818 return filepath.Join(xdgDataHome, appName, fmt.Sprintf("%s.json", appName))
819 }
820
821 // return the path to the main data directory
822 // for windows, it should be in `%LOCALAPPDATA%/crush/`
823 // for linux and macOS, it should be in `$HOME/.local/share/crush/`
824 if runtime.GOOS == "windows" {
825 localAppData := cmp.Or(
826 os.Getenv("LOCALAPPDATA"),
827 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
828 )
829 return filepath.Join(localAppData, appName, fmt.Sprintf("%s.json", appName))
830 }
831
832 return filepath.Join(home.Dir(), ".local", "share", appName, fmt.Sprintf("%s.json", appName))
833}
834
835// GlobalWorkspaceDir returns the path to the global server workspace
836// directory. This directory acts as a meta-workspace for the server
837// process, giving it a real workingDir so that config loading, scoped
838// writes, and provider resolution behave identically to project
839// workspaces.
840func GlobalWorkspaceDir() string {
841 return filepath.Dir(GlobalConfigData())
842}
843
844func assignIfNil[T any](ptr **T, val T) {
845 if *ptr == nil {
846 *ptr = &val
847 }
848}
849
850func isInsideWorktree() bool {
851 bts, err := exec.CommandContext(
852 context.Background(),
853 "git", "rev-parse",
854 "--is-inside-work-tree",
855 ).CombinedOutput()
856 return err == nil && strings.TrimSpace(string(bts)) == "true"
857}
858
859// GlobalSkillsDirs returns the default directories for Agent Skills.
860// Skills in these directories are auto-discovered and their files can be read
861// without permission prompts.
862func GlobalSkillsDirs() []string {
863 if crushSkills := os.Getenv("CRUSH_SKILLS_DIR"); crushSkills != "" {
864 return []string{crushSkills}
865 }
866
867 paths := []string{
868 filepath.Join(home.Config(), appName, "skills"),
869 filepath.Join(home.Config(), "agents", "skills"),
870 }
871
872 // On Windows, also load from app data on top of `$HOME/.config/crush`.
873 // This is here mostly for backwards compatibility.
874 if runtime.GOOS == "windows" {
875 appData := cmp.Or(
876 os.Getenv("LOCALAPPDATA"),
877 filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local"),
878 )
879 paths = append(
880 paths,
881 filepath.Join(appData, appName, "skills"),
882 filepath.Join(appData, "agents", "skills"),
883 )
884 }
885
886 return paths
887}
888
889// ProjectSkillsDir returns the default project directories for which Crush
890// will look for skills.
891func ProjectSkillsDir(workingDir string) []string {
892 return []string{
893 filepath.Join(workingDir, ".agents/skills"),
894 filepath.Join(workingDir, ".crush/skills"),
895 filepath.Join(workingDir, ".claude/skills"),
896 filepath.Join(workingDir, ".cursor/skills"),
897 }
898}
899
900func isAppleTerminal() bool { return os.Getenv("TERM_PROGRAM") == "Apple_Terminal" }
901
902// normalizeHookEvent maps user-provided event names to their canonical
903// form. Matching is case-insensitive and accepts snake_case variants
904// (e.g. "pre_tool_use" → "PreToolUse").
905func normalizeHookEvent(name string) string {
906 switch strings.ToLower(strings.ReplaceAll(name, "_", "")) {
907 case "pretooluse":
908 return "PreToolUse"
909 default:
910 return name
911 }
912}
913
914// ValidateHooks normalizes event names and checks that every configured
915// hook has a command and a syntactically valid matcher regex. Matcher
916// compilation used for matching is owned by hooks.Runner; this function
917// only validates up front so the user sees config errors at load time
918// rather than on the first tool call.
919func (c *Config) ValidateHooks() error {
920 // Normalize event name keys.
921 for event, eventHooks := range c.Hooks {
922 canonical := normalizeHookEvent(event)
923 if canonical != event {
924 c.Hooks[canonical] = append(c.Hooks[canonical], eventHooks...)
925 delete(c.Hooks, event)
926 }
927 }
928
929 for event, eventHooks := range c.Hooks {
930 for i, h := range eventHooks {
931 if h.Command == "" {
932 return fmt.Errorf("hook %s[%d]: command is required", event, i)
933 }
934 if h.Matcher == "" {
935 continue
936 }
937 if _, err := regexp.Compile(h.Matcher); err != nil {
938 return fmt.Errorf("hook %s[%d]: invalid matcher regex %q: %w", event, i, h.Matcher, err)
939 }
940 }
941 }
942 return nil
943}