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

Aperta
#3,719 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
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

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.