aws / aws/amazon-q-developer-cli
Global steering files in ~/.kiro/steering/ not loaded by kiro-cli chat. I have steering files in ~/.kiro/steering/ with inclusion: always frontmatter. When I run kiro-cli chat from a project directory that has its own .kiro/steering/ folder, only the proje
- Lingua principale
- Rust
- Stelle
- 2k
- Fork
- 439
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Descrizione
### Checks
- [x] I have searched [github.com/aws/amazon-q-developer-cli/issues](https://github.com/aws/amazon-q-developer-cli/issues?q=) and there are no duplicates of my issue
- [x] I have run `q doctor` in the affected terminal session
- [x] I have run `q restart` and replicated the issue again
### Operating system
macOS 26.3.1 (25D2128)
### Expected behaviour
load the Global steering file at kiro-cli start up.
I have steering files in ~/.kiro/steering/ with inclusion: always frontmatter. When I run kiro-cli chat from a project directory that has its own .kiro/steering/ folder, only the project-level steering
files are injected into the session context — the global ones are ignored.
Expected behavior: Files in ~/.kiro/steering/ with inclusion: always should be loaded in every session regardless of which project directory I'm in, similar to how ~/.gitconfig applies globally.
Current workaround: Symlinking global steering files into each project's .kiro/steering/ directory.
Questions:
1. Is ~/.kiro/steering/ intended to work as a global steering directory?
2. If so, is there a config flag to enable it?
3. If not, is there a planned mechanism for user-level steering files that apply across all projects?
Environment:
- kiro-cli version: (run kiro-cli --version)
- macOS
### Actual behaviour
does not load the global steering files. It load only the workspace level steering files
### Steps to reproduce
kiro-cli
### Environment
```yaml
[q-details]
version = "1.29.2"
hash = "874d4cb11bf441cda6122c6c8569b2322b7845b0"
date = "2026-04-03T22:01:10.564766Z (17h ago)"
variant = "full"
[system-info]
os = "macOS 26.3.1 (25D2128)"
chip = "Apple M4"
total-cores = 10
memory = "24.00 GB"
[environment]
cwd = "/Users/USER/aws-idr-alarms"
cli-path = "/Users/USER/aws-idr-alarms"
os = "Mac"
shell-path = "/bin/bash"
shell-version = "3.2.57"
terminal = "macOS"
install-method = "unknown"
[env-vars]
PATH = "/Users/USER/.aim/mcp-servers:/Users/USER/.toolbox/bin:/opt/homebrew/opt/python@3.14/libexec/bin:/opt/homebrew/bin:/Users/USER/.local/bin:/Users/USER/.local/bin/kiro-cli:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/opt/pmk/env/global/bin:/opt/homebrew/bin"
SHELL = "/bin/zsh"
TERM = "xterm-256color"
__CFBundleIdentifier = "com.apple.Terminal"
```
Guida per i contributori
Apri la guida per i contributori
Direzione di ricerca
Inizia riproducendo `kiro-cli chat` con `~/.kiro/steering/` e una directory `.kiro/steering/` del progetto, quindi traccia il percorso di caricamento degli steering utilizzato all'avvio di `kiro-cli`. Il lavoro è completato quando i file con `inclusion: always` nella directory globale vengono caricati insieme ai file di steering del progetto in ogni sessione, oppure quando viene documentato il comportamento di configurazione supportato.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- rust
- Ambito
- cli
- Tipo di issue
- Bug
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Tranquilla
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 50/100