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

Open
#3,719 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
Rust
Stars
2k
Forks
439
PR merge metrics
No merged PRs in 30d

Description

### 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"
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.