From 5591e4046de370941bc89800f0497daec61b337d Mon Sep 17 00:00:00 2001 From: wangsen35 Date: Tue, 25 Nov 2025 15:04:13 +0800 Subject: [PATCH 1/4] =?UTF-8?q?feat(=E6=9E=84=E5=BB=BA=E7=B3=BB=E7=BB=9F):?= =?UTF-8?q?=20=E6=B7=BB=E5=8A=A0JoyCode=20IDE=E6=94=AF=E6=8C=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/scripts/create-github-release.sh | 2 ++ .../workflows/scripts/create-release-packages.ps1 | 6 +++++- .../workflows/scripts/create-release-packages.sh | 5 ++++- AGENTS.md | 1 + README.md | 4 +++- scripts/bash/update-agent-context.sh | 13 +++++++++++-- scripts/powershell/update-agent-context.ps1 | 11 +++++++---- src/specify_cli/__init__.py | 8 +++++++- 8 files changed, 40 insertions(+), 10 deletions(-) diff --git a/.github/workflows/scripts/create-github-release.sh b/.github/workflows/scripts/create-github-release.sh index c09a255bac..90139988f1 100644 --- a/.github/workflows/scripts/create-github-release.sh +++ b/.github/workflows/scripts/create-github-release.sh @@ -46,5 +46,7 @@ gh release create "$VERSION" \ .genreleases/spec-kit-template-shai-ps-"$VERSION".zip \ .genreleases/spec-kit-template-q-sh-"$VERSION".zip \ .genreleases/spec-kit-template-q-ps-"$VERSION".zip \ + .genreleases/spec-kit-template-joycode-sh-"$VERSION".zip \ + .genreleases/spec-kit-template-joycode-ps-"$VERSION".zip \ --title "Spec Kit Templates - $VERSION_NO_V" \ --notes-file release_notes.md diff --git a/.github/workflows/scripts/create-release-packages.ps1 b/.github/workflows/scripts/create-release-packages.ps1 index f935dbe86d..fa10b4b4ad 100644 --- a/.github/workflows/scripts/create-release-packages.ps1 +++ b/.github/workflows/scripts/create-release-packages.ps1 @@ -335,6 +335,10 @@ function Build-Variant { $cmdDir = Join-Path $baseDir ".agents/commands" Generate-Commands -Agent 'amp' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script } + 'joycode' { + $cmdDir = Join-Path $baseDir ".joycode/commands" + Generate-Commands -Agent 'joycode' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script + } 'q' { $cmdDir = Join-Path $baseDir ".amazonq/prompts" Generate-Commands -Agent 'q' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script @@ -348,7 +352,7 @@ function Build-Variant { } # Define all agents and scripts -$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q') +$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp','joycode', 'q') $AllScripts = @('sh', 'ps') function Normalize-List { diff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.sh index 1f5c6e51b2..71151fc340 100755 --- a/.github/workflows/scripts/create-release-packages.sh +++ b/.github/workflows/scripts/create-release-packages.sh @@ -208,6 +208,9 @@ build_variant() { shai) mkdir -p "$base_dir/.shai/commands" generate_commands shai md "\$ARGUMENTS" "$base_dir/.shai/commands" "$script" ;; + joycode) + mkdir -p "$base_dir/.joycode/commands" + generate_commands joycode md "\$ARGUMENTS" "$base_dir/.joycode/commands" "$script" ;; q) mkdir -p "$base_dir/.amazonq/prompts" generate_commands q md "\$ARGUMENTS" "$base_dir/.amazonq/prompts" "$script" ;; @@ -217,7 +220,7 @@ build_variant() { } # Determine agent list -ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q) +ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai joycode q) ALL_SCRIPTS=(sh ps) norm_list() { diff --git a/AGENTS.md b/AGENTS.md index 3016c3eda3..9ce1cfa10f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -46,6 +46,7 @@ Specify supports multiple AI agents by generating agent-specific command files a | **Amazon Q Developer CLI** | `.amazonq/prompts/` | Markdown | `q` | Amazon Q Developer CLI | | **Amp** | `.agents/commands/` | Markdown | `amp` | Amp CLI | | **SHAI** | `.shai/commands/` | Markdown | `shai` | SHAI CLI | +| **JoyCode** | `.joycode/commands/`| Markdown | N/A (IDE-based) | JoyCode IDE | ### Step-by-Step Integration Guide diff --git a/README.md b/README.md index c3dcdf269c..169eb5f2c9 100644 --- a/README.md +++ b/README.md @@ -151,6 +151,8 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c | [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. | | [Amp](https://ampcode.com/) | ✅ | | | [SHAI (OVHcloud)](https://github.com/ovh/shai) | ✅ | | +| [JoyCode](https://joycode.jd.com/)| ✅ | | + ## 🔧 Specify CLI Reference @@ -161,7 +163,7 @@ The `specify` command supports the following options: | Command | Description | |-------------|----------------------------------------------------------------| | `init` | Initialize a new Specify project from the latest template | -| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`) | +| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`, `JoyCode`) | ### `specify init` Arguments & Options diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.sh index e0aa1de402..271235fffc 100644 --- a/scripts/bash/update-agent-context.sh +++ b/scripts/bash/update-agent-context.sh @@ -30,7 +30,7 @@ # # 5. Multi-Agent Support # - Handles agent-specific file paths and naming conventions -# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Amp, SHAI, or Amazon Q Developer CLI +# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, JoyCode, CodeBuddy CLI, Amp, SHAI, or Amazon Q Developer CLI # - Can update single agents or all existing agent files # - Creates default Claude file if no agent files exist # @@ -73,6 +73,7 @@ CODEBUDDY_FILE="$REPO_ROOT/CODEBUDDY.md" AMP_FILE="$REPO_ROOT/AGENTS.md" SHAI_FILE="$REPO_ROOT/SHAI.md" Q_FILE="$REPO_ROOT/AGENTS.md" +JOYCODE_FILE="$REPO_ROOT/.joycode/rules/specify-rules.md" # Template file TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md" @@ -622,12 +623,15 @@ update_specific_agent() { shai) update_agent_file "$SHAI_FILE" "SHAI" ;; + joycode) + update_agent_file "$JOYCODE_FILE" "JoyCode" + ;; q) update_agent_file "$Q_FILE" "Amazon Q Developer CLI" ;; *) log_error "Unknown agent type '$agent_type'" - log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|shai|q" + log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|shai|joycode|q" exit 1 ;; esac @@ -697,6 +701,11 @@ update_all_existing_agents() { found_agent=true fi + if [[ -f "$JOYCODE_FILE" ]]; then + update_agent_file "$JOYCODE_FILE" "JoyCode" + found_agent=true + fi + if [[ -f "$Q_FILE" ]]; then update_agent_file "$Q_FILE" "Amazon Q Developer CLI" found_agent=true diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1 index ea5654cce3..86f6f7abd4 100644 --- a/scripts/powershell/update-agent-context.ps1 +++ b/scripts/powershell/update-agent-context.ps1 @@ -9,7 +9,7 @@ Mirrors the behavior of scripts/bash/update-agent-context.sh: 2. Plan Data Extraction 3. Agent File Management (create from template or update existing) 4. Content Generation (technology stack, recent changes, timestamp) - 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, q) + 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, joycode, q) .PARAMETER AgentType 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 #> param( [Parameter(Position=0)] - [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','q')] + [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai', 'joycode','q')] [string]$AgentType ) @@ -57,6 +57,7 @@ $ROO_FILE = Join-Path $REPO_ROOT '.roo/rules/specify-rules.md' $CODEBUDDY_FILE = Join-Path $REPO_ROOT 'CODEBUDDY.md' $AMP_FILE = Join-Path $REPO_ROOT 'AGENTS.md' $SHAI_FILE = Join-Path $REPO_ROOT 'SHAI.md' +$JOYCODE_FILE = Join-Path $REPO_ROOT '.joycode/rules/specify-rules.md' $Q_FILE = Join-Path $REPO_ROOT 'AGENTS.md' $TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md' @@ -383,8 +384,9 @@ function Update-SpecificAgent { 'codebuddy' { Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI' } 'amp' { Update-AgentFile -TargetFile $AMP_FILE -AgentName 'Amp' } 'shai' { Update-AgentFile -TargetFile $SHAI_FILE -AgentName 'SHAI' } + 'joycode' { Update-AgentFile -TargetFile $JOYCODE_FILE -AgentName 'JoyCode' } 'q' { Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI' } - 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'; return $false } + 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|joycode|q'; return $false } } } @@ -403,6 +405,7 @@ function Update-AllExistingAgents { if (Test-Path $ROO_FILE) { if (-not (Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code')) { $ok = $false }; $found = $true } if (Test-Path $CODEBUDDY_FILE) { if (-not (Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI')) { $ok = $false }; $found = $true } if (Test-Path $SHAI_FILE) { if (-not (Update-AgentFile -TargetFile $SHAI_FILE -AgentName 'SHAI')) { $ok = $false }; $found = $true } + if (Test-Path $JOYCODE_FILE) { if (-not (Update-AgentFile -TargetFile $JOYCODE_FILE -AgentName 'JoyCode')) { $ok = $false }; $found = $true } if (Test-Path $Q_FILE) { if (-not (Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI')) { $ok = $false }; $found = $true } if (-not $found) { Write-Info 'No existing agent files found, creating default Claude file...' @@ -418,7 +421,7 @@ function Print-Summary { if ($NEW_FRAMEWORK) { Write-Host " - Added framework: $NEW_FRAMEWORK" } if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host " - Added database: $NEW_DB" } Write-Host '' - Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q]' + Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|joycode|q]' } function Main { diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.py index 2fa6455a29..8ae0f58436 100644 --- a/src/specify_cli/__init__.py +++ b/src/specify_cli/__init__.py @@ -196,6 +196,12 @@ def _format_rate_limit_error(status_code: int, headers: httpx.Headers, url: str) "install_url": None, # IDE-based "requires_cli": False, }, + "joycdode": { + "name": "JoyCode", + "folder": ".joycode/", + "install_url": None, # IDE-based + "requires_cli": False, + }, "q": { "name": "Amazon Q Developer CLI", "folder": ".amazonq/", @@ -933,7 +939,7 @@ def ensure_executable_scripts(project_path: Path, tracker: StepTracker | None = @app.command() def init( project_name: str = typer.Argument(None, help="Name for your new project directory (optional if using --here, or use '.' for current directory)"), - 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, or q"), + 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, joycode, or q"), script_type: str = typer.Option(None, "--script", help="Script type to use: sh or ps"), ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for AI agent tools like Claude Code"), no_git: bool = typer.Option(False, "--no-git", help="Skip git repository initialization"), From a0d82447ccf8907c136ec1b26d7046b60ec19e45 Mon Sep 17 00:00:00 2001 From: wangsen35 Date: Tue, 25 Nov 2025 15:38:35 +0800 Subject: [PATCH 2/4] fix(joycode): Fix the spelling error in the Joycode configuration item --- src/specify_cli/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.py index 8ae0f58436..a932ef4ff7 100644 --- a/src/specify_cli/__init__.py +++ b/src/specify_cli/__init__.py @@ -196,7 +196,7 @@ def _format_rate_limit_error(status_code: int, headers: httpx.Headers, url: str) "install_url": None, # IDE-based "requires_cli": False, }, - "joycdode": { + "joycode": { "name": "JoyCode", "folder": ".joycode/", "install_url": None, # IDE-based From 6009a161ee6b123f47e7fdffb6998acd35738f53 Mon Sep 17 00:00:00 2001 From: sanmu-2020 Date: Mon, 8 Dec 2025 15:31:36 +0800 Subject: [PATCH 3/4] Update README.md Co-authored-by: Den Delimarsky <53200638+localden@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 120caacc5b..459bf39652 100644 --- a/README.md +++ b/README.md @@ -169,7 +169,7 @@ The `specify` command supports the following options: | Command | Description | |-------------|----------------------------------------------------------------| | `init` | Initialize a new Specify project from the latest template | -| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`, `JoyCode`) | +| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `shai`, `joycode`) | ### `specify init` Arguments & Options From 5483a6f1c81c59e140dc18b8a7d04214217b69b4 Mon Sep 17 00:00:00 2001 From: wangsen35 Date: Mon, 8 Dec 2025 15:33:52 +0800 Subject: [PATCH 4/4] docs(README): delete Codex CLI content --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 459bf39652..3535900312 100644 --- a/README.md +++ b/README.md @@ -151,7 +151,6 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c | [opencode](https://opencode.ai/) | ✅ | | | [Qwen Code](https://github.com/QwenLM/qwen-code) | ✅ | | | [Roo Code](https://roocode.com/) | ✅ | | -| [Codex CLI](https://github.com/openai/codex) | ✅ | | | [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. | | [Amp](https://ampcode.com/) | ✅ | | | [SHAI (OVHcloud)](https://github.com/ovh/shai) | ✅ | |