Skip to content

Commit f8c9ba0

Browse files
committed
fix(docs,aliases): remove aspirational Amazon Q --mcp-config support
- Update ai-provider-agnosticism.md to reflect reality: Amazon Q uses MCP subcommands, not CLI flags - Clean up duplicate lines in ai-providers.sh - Document that Amazon Q imports MCP config during setup, not via alias - Add explanatory comments about the different integration methods Amazon Q 1.12.7 does not support --mcp-config or --add-dir flags. MCP configuration is handled through `q mcp import` during setup.sh execution. Principle: systems-stewardship
1 parent 9a6844d commit f8c9ba0

2 files changed

Lines changed: 10 additions & 15 deletions

File tree

.bash_aliases.d/ai-providers.sh

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,7 @@ else
77
alias claude='claude --mcp-config "$DOT_DEN/mcp/mcp.json" --add-dir "$DOT_DEN/knowledge"'
88
fi
99

10-
DOT_DEN="${DOT_DEN:-$HOME/ppv/pillars/dotfiles}"
11-
12-
# Common parameters for claude and q aliases
13-
COMMON_PARAMS="--mcp-config \"$DOT_DEN/mcp/mcp.json\" --add-dir \"$DOT_DEN/knowledge\""
14-
15-
# Claude alias with automatic Opus model on personal machines
16-
if [[ "${WORK_MACHINE}" != "true" ]]; then
17-
alias claude="claude --model claude-opus-4-20250514 $COMMON_PARAMS"
18-
else
19-
alias claude="claude $COMMON_PARAMS"
20-
fi
21-
22-
alias q="q $COMMON_PARAMS"
10+
# Amazon Q uses MCP subcommands, not --mcp-config flag
11+
# MCP servers are imported by setup-provider-agnostic-mcp.sh during setup
12+
# To manually import: q mcp import --file "$DOT_DEN/mcp/mcp.json" global --force
13+
alias q='q'

knowledge/principles/ai-provider-agnosticism.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,15 @@ AI services experience outages and rate limits. Provider agnosticism enables sea
88

99
## Architecture Pattern
1010

11-
**Symmetric Configuration**: Both providers use identical MCP servers and knowledge directory patterns:
11+
**Symmetric Capabilities**: Both providers access identical MCP servers and knowledge directory, but through different integration methods:
1212

1313
```bash
14+
# Claude Code: Direct file reference via CLI flags
1415
alias claude='claude --mcp-config "$DOT_DEN/mcp/mcp.json" --add-dir "$DOT_DEN/knowledge"'
15-
alias q='q --mcp-config "$DOT_DEN/mcp/mcp.json" --add-dir "$DOT_DEN/knowledge"'
16+
17+
# Amazon Q: MCP import during setup (no CLI flag support)
18+
# Setup runs: q mcp import --file "$DOT_DEN/mcp/mcp.json" global --force
19+
alias q='q'
1620
```
1721

1822
## Implementation

0 commit comments

Comments
 (0)