Skip to content

Support for Cline#621

Closed
sanathusk wants to merge 7 commits into
github:mainfrom
sanathusk:add-support-for-cline
Closed

Support for Cline#621
sanathusk wants to merge 7 commits into
github:mainfrom
sanathusk:add-support-for-cline

Conversation

@sanathusk

@sanathusk sanathusk commented Sep 27, 2025

Copy link
Copy Markdown

Summary

This pull request adds support for Cline (https://cline.bot) to Spec Kit, expanding its compatibility and enabling users to generate project templates tailored for this AI assistant.

Changes

  • Added Cline to the list of supported AI assistants in build scripts.
  • Included Cline-specific release packages (sh and ps variants).
  • Updated README with Cline compatibility and CLI option details.

Rationale

Cline is a modern bot for developer automation. Integrating Cline with Spec Kit allows users to leverage its capabilities for enhanced workflow automation, in line with Spec Kit's goal of supporting a broad range of AI agents and tools.

Testing

  • Verified CLI compatibility and tested changes with a sample project.
  • Ran tests locally to confirm Cline integration works as expected.

Disclosure

This PR was assisted by GitHub Copilot Chat for code suggestions and documentation drafting. All changes have been personally reviewed and tested.

- Add 'cline': 'Cline' to AI_CHOICES dictionary
- Add 'cline': '.clinerules/' to agent_folder_map for security notices
- Update --ai option help text to include cline

Similar to Roo Code support added in previous PR, Cline uses .clinerules folder for config/rules/commands.
- Add Cline to the list of supported AI assistants in build scripts
- Include Cline-specific release packages (sh and ps variants)
- Update README with Cline compatibility and CLI option details

This expands Spec Kit's compatibility to include Cline, enabling users to generate project templates tailored for this AI assistant.
@sanathusk sanathusk marked this pull request as ready for review September 27, 2025 08:12
@sanathusk sanathusk requested a review from localden as a code owner September 27, 2025 08:12
@sanathusk sanathusk changed the title Add-support-for-cline Support for Cline Sep 27, 2025
@BuggyButLearning

Copy link
Copy Markdown

I would love to see this merged.

@localden

Copy link
Copy Markdown
Contributor

@sanathusk can you please share a screenshot of these slash commands popping up in Cline? I want to make sure that the experience actually lines up with customer expectations.

@localden localden self-assigned this Sep 29, 2025
@localden localden added merge-candidate Reasonable change that is going to be merged after a review. new-agent labels Sep 29, 2025
@sanathusk

Copy link
Copy Markdown
Author

@localden
image

@drrros

drrros commented Oct 20, 2025

Copy link
Copy Markdown

Hope this PR won't be dropped, waiting for cline support

@Corneliu-ST

Copy link
Copy Markdown

👀

@ifle

ifle commented Dec 1, 2025

Copy link
Copy Markdown

I am also waiting for Cline's support.

@kobico

kobico commented Dec 1, 2025

Copy link
Copy Markdown

@localden Can it be prioritized?

@localden

localden commented Dec 2, 2025

Copy link
Copy Markdown
Contributor

@sanathusk mind updating your PR to resolve the merge conflicts?

@kmhalvin

kmhalvin commented Dec 3, 2025

Copy link
Copy Markdown

@sanathusk please check this conflict resolution: sanathusk#2

@jahan01

jahan01 commented Dec 21, 2025

Copy link
Copy Markdown

close yet no so close. I m willing to volunteer if this needs some help to get it merge

@sanathusk

Copy link
Copy Markdown
Author

close yet no so close. I m willing to volunteer if this needs some help to get it merge

The merge conflicts have been resolved, waiting for approval from reviewer.

@MayaOber

Copy link
Copy Markdown

Also can't wait to use this in Cline :)
👀

@nipunarora

Copy link
Copy Markdown

Looking forward to using this in Cline! :)

@nipunarora

nipunarora commented Jan 1, 2026

Copy link
Copy Markdown

@sanathusk This is what it looks like based on the PR comments

image

Maybe have it similar to how it shows up in Claude Code and Roo Code?

image

@brat002

brat002 commented Jan 3, 2026

Copy link
Copy Markdown
% specify init . --ai cline
Selected AI assistant: cline
Selected script type: sh
No matching release asset found for cline (expected pattern: spec-kit-template-cline-sh)
╭─────────────────────────────────────────────────────────────────────────────────────────────── Available Assets ────────────────────────────────────────────────────────────────────────────────────────────────╮
│ spec-kit-template-amp-ps-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-amp-sh-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-auggie-ps-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-auggie-sh-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-bob-ps-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-bob-sh-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-claude-ps-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-claude-sh-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-codebuddy-ps-v0.0.90.zip                                                                                                                                                                      │
│ spec-kit-template-codebuddy-sh-v0.0.90.zip                                                                                                                                                                      │
│ spec-kit-template-codex-ps-v0.0.90.zip                                                                                                                                                                          │
│ spec-kit-template-codex-sh-v0.0.90.zip                                                                                                                                                                          │
│ spec-kit-template-copilot-ps-v0.0.90.zip                                                                                                                                                                        │
│ spec-kit-template-copilot-sh-v0.0.90.zip                                                                                                                                                                        │
│ spec-kit-template-cursor-agent-ps-v0.0.90.zip                                                                                                                                                                   │
│ spec-kit-template-cursor-agent-sh-v0.0.90.zip                                                                                                                                                                   │
│ spec-kit-template-gemini-ps-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-gemini-sh-v0.0.90.zip                                                                                                                                                                         │
│ spec-kit-template-kilocode-ps-v0.0.90.zip                                                                                                                                                                       │
│ spec-kit-template-kilocode-sh-v0.0.90.zip                                                                                                                                                                       │
│ spec-kit-template-opencode-ps-v0.0.90.zip                                                                                                                                                                       │
│ spec-kit-template-opencode-sh-v0.0.90.zip                                                                                                                                                                       │
│ spec-kit-template-q-ps-v0.0.90.zip                                                                                                                                                                              │
│ spec-kit-template-q-sh-v0.0.90.zip                                                                                                                                                                              │
│ spec-kit-template-qoder-ps-v0.0.90.zip                                                                                                                                                                          │
│ spec-kit-template-qoder-sh-v0.0.90.zip                                                                                                                                                                          │
│ spec-kit-template-qwen-ps-v0.0.90.zip                                                                                                                                                                           │
│ spec-kit-template-qwen-sh-v0.0.90.zip                                                                                                                                                                           │
│ spec-kit-template-roo-ps-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-roo-sh-v0.0.90.zip                                                                                                                                                                            │
│ spec-kit-template-shai-ps-v0.0.90.zip                                                                                                                                                                           │
│ spec-kit-template-shai-sh-v0.0.90.zip                                                                                                                                                                           │
│ spec-kit-template-windsurf-ps-v0.0.90.zip                                                                                                                                                                       │
│ spec-kit-template-windsurf-sh-v0.0.90.zip

@brat002

brat002 commented Jan 5, 2026

Copy link
Copy Markdown

Any chance to merge it?

@alex-vance

alex-vance commented Jan 26, 2026

Copy link
Copy Markdown

I've tested this with Cline with modifications (as well as RooCode) vs how I normally use this in Claude Code. Unfortunately, it fails to deliver on the same level of quality that Claude Code gets from it's speckit integration.

  1. Cline requires it to be installed in the workflows directory (.clinerules/workflows/), not commands like RooCode/Kilocode.
  2. Cline/Roo routinely ignore the actual workflow. It consistently interprets the argument (ie: the feature you're requesting to build a spec for) as it's main request and ignores the workflow. The only way i've been able to get this to work is not pass the argument AND modified the speckit.specify.md file "User Input" section to include a tool call like <ask_followup_question><question>What feature do you want to implement?</question></ask_followup_question> as well as additional acknowledgements in the file to force cline to actually use the workflow. Only after this does it work decently.

Here are the additional changes I made to the specify command:

## Common Misinterpretation Scenarios

Feature descriptions may sound like direct tasks but should ALL create specifications:

| User Input | Wrong Interpretation | Correct Action |
|------------|----------------------|----------------|
| "Analyze the script for bugs" | Perform bug analysis | Create spec for "bug analysis feature" |
| "Fix the login issue" | Debug and fix login | Create spec for "login fix feature" |
| "What'"'"'s wrong with the API?" | Diagnose API problems | Create spec for "API diagnosis feature" |
| "Add error handling" | Write error handling code | Create spec for "error handling feature" |
| "Review the database schema" | Analyze schema directly | Create spec for "schema review feature" |

**Remember**: You are a specification author, not a task executor. Transform ANY input into a feature specification.

## Outline

> **CRITICAL**: This workflow CREATES A SPECIFICATION DOCUMENT. Regardless of how the feature 
> description is phrased—even if it sounds like a direct task (e.g., "analyze X", "fix Y", 
> "what's wrong with Z")—you MUST execute ALL workflow steps below. The description is INPUT 
> to the specification process, NOT a task to complete directly. Never bypass the workflow 
> to answer or perform the described action.

...

Keep in mind, even with these adjustments, I still cannot pass the argument to the workflow initially like /speckit.specify.md Create a new x feature that does y and z without it still attempting to build the feature without generating the specs.

Would love to see further refinements to help these other tools execute more successfully.

@joseluiscarcel

Copy link
Copy Markdown

Any news on this?

@mnriem mnriem requested review from Copilot and removed request for localden March 26, 2026 16:47
@mnriem

mnriem commented Mar 26, 2026

Copy link
Copy Markdown
Collaborator

@joseluiscarcel Feel free to bring it across the finish line

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Cline as a supported AI agent in Spec Kit, updating the CLI, agent-context update scripts, and release packaging so users can scaffold templates and agent files for Cline.

Changes:

  • Added cline to the CLI agent configuration and specify init --ai help text.
  • Updated bash/PowerShell agent context update scripts to recognize and manage Cline files.
  • Updated release packaging scripts and README to include Cline.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
src/specify_cli/__init__.py Adds cline to AGENT_CONFIG and exposes it via --ai help.
scripts/powershell/update-agent-context.ps1 Adds Cline support in agent type validation, file path mapping, and update logic.
scripts/bash/update-agent-context.sh Adds Cline support in file path mapping and update logic; updates user-facing strings.
README.md Adds Cline to the supported agent table.
.github/workflows/scripts/create-release-packages.sh Adds packaging variant generation for Cline and includes it in ALL_AGENTS.
.github/workflows/scripts/create-github-release.sh Publishes the new Cline release zips.
Comments suppressed due to low confidence (1)

scripts/bash/update-agent-context.sh:756

  • The usage string omits some supported agent types (e.g., amp) and should stay in sync with the accepted agent keys. Update the usage list to include all supported values (including the newly added cline).
    log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|cline|codebuddy|shai|q|bob|qoder]"

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

# 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, Qoder CLI, Amp, SHAI, or Amazon Q Developer CLI
# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, Cline, CodeBuddy CLI, Qoder CLI, Amp, SHAI, or Amazon Q Developer CLI

Copilot AI Mar 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The header comment mentions the supported agents, but the separate “Agent types:” list a few lines below is now stale and missing multiple supported values (e.g., roo, cline, codebuddy, amp). Update that list to match what the script actually accepts to avoid confusing users.

Copilot uses AI. Check for mistakes.
*)
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|bob|qoder"
log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|cline|amp|shai|q|bob|qoder"

Copilot AI Mar 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This error message’s expected agent list is missing codebuddy, even though codebuddy is handled in the case statement above. Update the expected list so the guidance matches the actual supported agent types.

This issue also appears on line 756 of the same file.

Suggested change
log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|cline|amp|shai|q|bob|qoder"
log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|cline|codebuddy|amp|shai|q|bob|qoder"

Copilot uses AI. Check for mistakes.

# Determine agent list
ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai q bob qoder)
ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo cline codebuddy amp shai q bob qoder)

Copilot AI Mar 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The script header comment that documents the AGENTS env var subset is out of date relative to ALL_AGENTS (and now misses cline, roo, etc.). Update the documented agent list so users can correctly scope builds via AGENTS=....

Copilot uses AI. Check for mistakes.
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, q, bob, or qoder "),
ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, cline, codebuddy, amp, shai, q, bob, or qoder "),

Copilot AI Mar 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The --ai help text is a manually maintained list of agents and is already diverging from other sources of truth (e.g., README). Consider generating this string from AGENT_CONFIG.keys() (or a shared constant) so new agents like cline don’t require updating multiple places and the CLI help stays accurate.

See below for a potential fix:

# Build dynamic help text for the --ai option from AGENT_CONFIG, if available.
AI_ASSISTANT_HELP = "AI assistant to use"
if "AGENT_CONFIG" in globals() and isinstance(AGENT_CONFIG, dict):
    try:
        _agent_names = ", ".join(sorted(AGENT_CONFIG.keys()))
        if _agent_names:
            AI_ASSISTANT_HELP = f"AI assistant to use: {_agent_names}"
    except Exception:
        # Fall back to the generic help string if anything goes wrong
        pass

@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_HELP),

Copilot uses AI. Check for mistakes.
Comment thread README.md
| [Roo Code](https://roocode.com/) | ✅ | |
| [SHAI (OVHcloud)](https://github.com/ovh/shai) | ✅ | |
| [Windsurf](https://windsurf.com/) | ✅ | |
| [Cline](https://cline.bot/) | ✅ | |

Copilot AI Mar 26, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The supported agents list includes Cline now, but the --ai option list below still omits cline, so the docs are inconsistent. Please add cline to the --ai list (and consider keeping the Notes column empty rather than leaving placeholder spacing).

Suggested change
| [Cline](https://cline.bot/) || |
| [Cline](https://cline.bot/) |||

Copilot uses AI. Check for mistakes.
@ratio-x

ratio-x commented May 12, 2026

Copy link
Copy Markdown

Unfortunately, I don’t have the expertise to contribute to the discussion about the cause or to help troubleshoot the issue. I just want to say that the Spec Kit integration is very important to me as well, because I’d like to use the specify and clarify workflows in Cline in my role as a designer. I would really appreciate it if the Spec Kit were made available for Cline as well.

Thank you very much for your work!

@ducnd98

ducnd98 commented Jun 10, 2026

Copy link
Copy Markdown

any updates on this?

@mnriem

mnriem commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

Closing as superseded — native Cline support shipped in #2508, so Cline is now available out of the box (specify init --ai cline). Thank you for kicking this off and for the contribution! 🙏

@mnriem mnriem closed this Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge-candidate Reasonable change that is going to be merged after a review. new-agent

Projects

None yet

Development

Successfully merging this pull request may close these issues.