Skip to content

Commit 7f6e3a8

Browse files
wolffy-auwolffy-au
committed
feat: add Aider CLI support and update related documentation
1 parent b791acc commit 7f6e3a8

12 files changed

Lines changed: 84 additions & 39 deletions

File tree

‎.devcontainer/devcontainer.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,8 @@
5353
// Amazon Developer Q
5454
"AmazonWebServices.amazon-q-vscode",
5555
// Claude Code
56-
"anthropic.claude-code"
56+
"anthropic.claude-code",
57+
"lee2py.aider-composer"
5758
],
5859
"settings": {
5960
"debug.javascript.autoAttachFilter": "disabled", // fix running commands in integrated terminal

‎.devcontainer/post-create.sh‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,10 @@ echo -e "\n🤖 Installing OpenCode CLI..."
5151
run_command "npm install -g opencode-ai@latest"
5252
echo "✅ Done"
5353

54+
echo -e "\n🤖 Installing Aider CLI..."
55+
run_command "pipx install aider-chat"
56+
echo "✅ Done"
57+
5458
echo -e "\n🤖 Installing Amazon Q CLI..."
5559
# 👉🏾 https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-verify-download.html
5660

‎.github/workflows/scripts/create-github-release.sh‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,5 +52,7 @@ gh release create "$VERSION" \
5252
.genreleases/spec-kit-template-agy-ps-"$VERSION".zip \
5353
.genreleases/spec-kit-template-bob-sh-"$VERSION".zip \
5454
.genreleases/spec-kit-template-bob-ps-"$VERSION".zip \
55+
.genreleases/spec-kit-template-aider-sh-"$VERSION".zip \
56+
.genreleases/spec-kit-template-aider-ps-"$VERSION".zip \
5557
--title "Spec Kit Templates - $VERSION_NO_V" \
5658
--notes-file release_notes.md

‎.github/workflows/scripts/create-release-packages.ps1‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
1515
.PARAMETER Agents
1616
Comma or space separated subset of agents to build (default: all)
17-
Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, q, bob, qoder
17+
Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, q, bob, qoder, aider
1818
1919
.PARAMETER Scripts
2020
Comma or space separated subset of script types to build (default: both)
@@ -347,6 +347,10 @@ function Build-Variant {
347347
$cmdDir = Join-Path $baseDir ".qoder/commands"
348348
Generate-Commands -Agent 'qoder' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
349349
}
350+
'aider' {
351+
$cmdDir = Join-Path $baseDir ".aider/commands"
352+
Generate-Commands -Agent 'aider' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
353+
}
350354
}
351355

352356
# Create zip archive
@@ -356,7 +360,7 @@ function Build-Variant {
356360
}
357361

358362
# Define all agents and scripts
359-
$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q', 'bob', 'qoder')
363+
$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q', 'bob', 'qoder', 'aider')
360364
$AllScripts = @('sh', 'ps')
361365

362366
function Normalize-List {

‎.github/workflows/scripts/create-release-packages.sh‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -221,13 +221,16 @@ build_variant() {
221221
bob)
222222
mkdir -p "$base_dir/.bob/commands"
223223
generate_commands bob md "\$ARGUMENTS" "$base_dir/.bob/commands" "$script" ;;
224+
aider)
225+
mkdir -p "$base_dir/.aider/commands"
226+
generate_commands aider md "\$ARGUMENTS" "$base_dir/.aider/commands" "$script" ;;
224227
esac
225228
( cd "$base_dir" && zip -r "../spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip" . )
226229
echo "Created $GENRELEASES_DIR/spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip"
227230
}
228231

229232
# Determine agent list
230-
ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q agy bob qoder)
233+
ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q agy bob qoder aider)
231234
ALL_SCRIPTS=(sh ps)
232235

233236
norm_list() {

‎AGENTS.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@ Specify supports multiple AI agents by generating agent-specific command files a
4848
| **Amp** | `.agents/commands/` | Markdown | `amp` | Amp CLI |
4949
| **SHAI** | `.shai/commands/` | Markdown | `shai` | SHAI CLI |
5050
| **IBM Bob** | `.bob/commands/` | Markdown | N/A (IDE-based) | IBM Bob IDE |
51+
| **Aider** | `.aider/commands/` | Markdown | `aider` | Aider CLI |
5152

5253
### Step-by-Step Integration Guide
5354

@@ -316,6 +317,7 @@ Require a command-line tool to be installed:
316317
- **Qoder CLI**: `qoder` CLI
317318
- **Amp**: `amp` CLI
318319
- **SHAI**: `shai` CLI
320+
- **Aider CLI**: `aider` CLI
319321

320322
### IDE-Based Agents
321323

‎README.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,7 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c
145145
| Agent | Support | Notes |
146146
| ------------------------------------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
147147
| [Qoder CLI](https://qoder.com/cli) | ✅ | |
148+
| [Aider CLI](https://aider.chat/) | ✅ | |
148149
| [Amazon Q Developer CLI](https://aws.amazon.com/developer/learning/q-developer-cli/) | ⚠️ | Amazon Q Developer CLI [does not support](https://github.com/aws/amazon-q-developer-cli/issues/3064) custom arguments for slash commands. |
149150
| [Amp](https://ampcode.com/) | ✅ | |
150151
| [Auggie CLI](https://docs.augmentcode.com/cli/overview) | ✅ | |
@@ -173,14 +174,14 @@ The `specify` command supports the following options:
173174
| Command | Description |
174175
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
175176
| `init` | Initialize a new Specify project from the latest template |
176-
| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`, `qoder`) |
177+
| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`, `qoder`, `aider`) |
177178

178179
### `specify init` Arguments & Options
179180

180181
| Argument/Option | Type | Description |
181182
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
182183
| `<project-name>` | Argument | Name for your new project directory (optional if using `--here`, or use `.` for current directory) |
183-
| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `q`, `agy`, `bob`, or `qoder` |
184+
| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `q`, `agy`, `bob`, `aider`, or `qoder` |
184185
| `--script` | Option | Script variant to use: `sh` (bash/zsh) or `ps` (PowerShell) |
185186
| `--ignore-agent-tools` | Flag | Skip checks for AI agent tools like Claude Code |
186187
| `--no-git` | Flag | Skip git repository initialization |
@@ -217,6 +218,9 @@ specify init my-project --ai shai
217218
# Initialize with IBM Bob support
218219
specify init my-project --ai bob
219220

221+
# Initialize with Aider support
222+
specify init my-project --ai aider
223+
220224
# Initialize with PowerShell scripts (Windows/cross-platform)
221225
specify init my-project --ai copilot --script ps
222226

@@ -382,7 +386,7 @@ specify init . --force --ai claude
382386
specify init --here --force --ai claude
383387
```
384388

385-
The CLI will check if you have Claude Code, Gemini CLI, Cursor CLI, Qwen CLI, opencode, Codex CLI, Qoder CLI, or Amazon Q Developer CLI installed. If you do not, or you prefer to get the templates without checking for the right tools, use `--ignore-agent-tools` with your command:
389+
The CLI will check if you have Claude Code, Gemini CLI, Cursor CLI, Qwen CLI, opencode, Codex CLI, Qoder CLI, Aider CLI, or Amazon Q Developer CLI installed. If you do not, or you prefer to get the templates without checking for the right tools, use `--ignore-agent-tools` with your command:
386390

387391
```bash
388392
specify init <project_name> --ai claude --ignore-agent-tools

‎scripts/bash/update-agent-context.sh‎

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,12 +30,12 @@
3030
#
3131
# 5. Multi-Agent Support
3232
# - Handles agent-specific file paths and naming conventions
33-
# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Amazon Q Developer CLI, or Antigravity
33+
# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Aider CLI, Amazon Q Developer CLI, or Antigravity
3434
# - Can update single agents or all existing agent files
3535
# - Creates default Claude file if no agent files exist
3636
#
3737
# Usage: ./update-agent-context.sh [agent_type]
38-
# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|shai|q|agy|bob|qoder
38+
# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|shai|q|agy|bob|qoder|aider
3939
# Leave empty to update all existing agent files
4040

4141
set -e
@@ -76,6 +76,7 @@ SHAI_FILE="$REPO_ROOT/SHAI.md"
7676
Q_FILE="$REPO_ROOT/AGENTS.md"
7777
AGY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"
7878
BOB_FILE="$REPO_ROOT/AGENTS.md"
79+
AIDER_FILE="$REPO_ROOT/.aider/rules/specify-rules.md"
7980

8081
# Template file
8182
TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"
@@ -637,9 +638,12 @@ update_specific_agent() {
637638
bob)
638639
update_agent_file "$BOB_FILE" "IBM Bob"
639640
;;
641+
aider)
642+
update_agent_file "$AIDER_FILE" "Aider CLI"
643+
;;
640644
*)
641645
log_error "Unknown agent type '$agent_type'"
642-
log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|shai|q|agy|bob|qoder"
646+
log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|shai|q|agy|bob|qoder|aider"
643647
exit 1
644648
;;
645649
esac
@@ -728,6 +732,11 @@ update_all_existing_agents() {
728732
update_agent_file "$BOB_FILE" "IBM Bob"
729733
found_agent=true
730734
fi
735+
736+
if [[ -f "$AIDER_FILE" ]]; then
737+
update_agent_file "$AIDER_FILE" "Aider CLI"
738+
found_agent=true
739+
fi
731740

732741
# If no agent files exist, create a default Claude file
733742
if [[ "$found_agent" == false ]]; then
@@ -753,7 +762,7 @@ print_summary() {
753762

754763
echo
755764

756-
log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|shai|q|agy|bob|qoder]"
765+
log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|shai|q|agy|bob|qoder|aider]"
757766
}
758767

759768
#==============================================================================

‎scripts/powershell/update-agent-context.ps1‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Mirrors the behavior of scripts/bash/update-agent-context.sh:
99
2. Plan Data Extraction
1010
3. Agent File Management (create from template or update existing)
1111
4. Content Generation (technology stack, recent changes, timestamp)
12-
5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, q, agy, bob, qoder)
12+
5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, q, agy, bob, aider, or qoder)
1313
1414
.PARAMETER AgentType
1515
Optional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).
@@ -25,7 +25,7 @@ Relies on common helper functions in common.ps1
2525
#>
2626
param(
2727
[Parameter(Position=0)]
28-
[ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','q','agy','bob','qoder')]
28+
[ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','q','agy','bob','qoder','aider')]
2929
[string]$AgentType
3030
)
3131

@@ -61,6 +61,7 @@ $SHAI_FILE = Join-Path $REPO_ROOT 'SHAI.md'
6161
$Q_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
6262
$AGY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'
6363
$BOB_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
64+
$AIDER_FILE = Join-Path $REPO_ROOT '.aider/rules/specify-rules.md'
6465

6566
$TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'
6667

@@ -390,7 +391,8 @@ function Update-SpecificAgent {
390391
'q' { Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI' }
391392
'agy' { Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity' }
392393
'bob' { Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob' }
393-
default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|agy|bob|qoder'; return $false }
394+
'aider' { Update-AgentFile -TargetFile $AIDER_FILE -AgentName 'Aider CLI' }
395+
default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|agy|bob|qoder|aider'; return $false }
394396
}
395397
}
396398

@@ -413,6 +415,7 @@ function Update-AllExistingAgents {
413415
if (Test-Path $Q_FILE) { if (-not (Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI')) { $ok = $false }; $found = $true }
414416
if (Test-Path $AGY_FILE) { if (-not (Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity')) { $ok = $false }; $found = $true }
415417
if (Test-Path $BOB_FILE) { if (-not (Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob')) { $ok = $false }; $found = $true }
418+
if (Test-Path $AIDER_FILE) { if (-not (Update-AgentFile -TargetFile $AIDER_FILE -AgentName 'Aider CLI')) { $ok = $false }; $found = $true }
416419
if (-not $found) {
417420
Write-Info 'No existing agent files found, creating default Claude file...'
418421
if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }
@@ -427,7 +430,7 @@ function Print-Summary {
427430
if ($NEW_FRAMEWORK) { Write-Host " - Added framework: $NEW_FRAMEWORK" }
428431
if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host " - Added database: $NEW_DB" }
429432
Write-Host ''
430-
Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|agy|bob|qoder]'
433+
Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|agy|bob|qoder|aider]'
431434
}
432435

433436
function Main {

‎src/specify_cli/__init__.py‎

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,12 @@ def _format_rate_limit_error(status_code: int, headers: httpx.Headers, url: str)
232232
"install_url": None, # IDE-based
233233
"requires_cli": False,
234234
},
235+
"aider": {
236+
"name": "Aider",
237+
"folder": ".aider/",
238+
"install_url": "https://aider.chat",
239+
"requires_cli": True,
240+
},
235241
}
236242

237243
SCRIPT_TYPE_CHOICES = {"sh": "POSIX Shell (bash/zsh)", "ps": "PowerShell"}
@@ -641,8 +647,8 @@ def deep_merge(base: dict, update: dict) -> dict:
641647
return merged
642648

643649
def download_template_from_github(ai_assistant: str, download_dir: Path, *, script_type: str = "sh", verbose: bool = True, show_progress: bool = True, client: httpx.Client = None, debug: bool = False, github_token: str = None) -> Tuple[Path, dict]:
644-
repo_owner = "github"
645-
repo_name = "spec-kit"
650+
repo_owner = "wolffy-au"
651+
repo_name = "spec-kit-aider"
646652
if client is None:
647653
client = httpx.Client(verify=ssl_context)
648654

@@ -986,7 +992,7 @@ def ensure_constitution_from_template(project_path: Path, tracker: StepTracker |
986992
@app.command()
987993
def init(
988994
project_name: str = typer.Argument(None, help="Name for your new project directory (optional if using --here, or use '.' for current directory)"),
989-
ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, shai, q, agy, bob, or qoder "),
995+
ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, shai, q, agy, bob, qoder, aider"),
990996
script_type: str = typer.Option(None, "--script", help="Script type to use: sh or ps"),
991997
ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for AI agent tools like Claude Code"),
992998
no_git: bool = typer.Option(False, "--no-git", help="Skip git repository initialization"),
@@ -1351,8 +1357,8 @@ def version():
13511357
pass
13521358

13531359
# Fetch latest template release version
1354-
repo_owner = "github"
1355-
repo_name = "spec-kit"
1360+
repo_owner = "wolffy-au"
1361+
repo_name = "spec-kit-aider"
13561362
api_url = f"https://api.github.com/repos/{repo_owner}/{repo_name}/releases/latest"
13571363

13581364
template_version = "unknown"

0 commit comments

Comments
 (0)