CTX 1.26.0 Release Notes 🎉

[butschster]

CTX 1.26.0 Release Notes 🎉

We're excited to announce version 1.26.0, packed with new features, enhancements, and documentation updates. This release focuses on improved GitLab integration, prompt tagging and filtering, and streamlined CLI interactions for MCP tools.

🚀 New Features

🌟 GitLab Source Integration

The new GitLab source component mirrors the existing GitHub functionality, providing robust integration to fetch code and documentation directly from GitLab repositories.

Read more in a documentation section GitLab Source

Example Configuration:

documents:
  - description: Self-hosted GitLab Documentation
    outputPath: docs/self-hosted-gitlab.md
    sources:
      - type: gitlab
        description: Self-hosted GitLab Project
        repository: group/project
        branch: main
        server:
          url: https://gitlab.test.com
          token: ${TEST_GITLAB_TOKEN}
        sourcePaths:
          - src
        filePattern: "*.php"

🔖 Advanced Prompt Tagging and Filtering

Organize and selectively import prompts more efficiently with advanced tagging and filtering capabilities, streamlining your workflow and reducing clutter in your prompt registries.

Read more in a documentation section Prompts Import

Example Configuration:

prompts:
  - id: creative-writing
    description: "Helps generate creative writing pieces"
    tags: ["writing", "creative", "content-generation"]
    messages:
      - role: user
        content: "You are a creative writing assistant..."

1. Prompt Tagging: Ability to assign tags to prompts in the YAML configuration

   prompts:
     - id: creative-writing
       description: "Helps generate creative writing pieces"
       tags: ["writing", "creative", "content-generation"]

2. ID-Based Import Filtering: Ability to import specific prompts by their IDs

   import:
     - url: "https://prompts-repository.example.com/prompts.yaml"
       filter:
         ids: ["python-helper", "php-debug", "js-refactor"]

3. Tag-Based Import Filtering: Support for filtering by tags with include/exclude logic

   import:
     - path: "./local-prompts.yaml"
       filter:
         tags:
           include: ["coding", "debugging"]
           exclude: ["advanced"]
         match: "any"  # can be "all" for AND logic

📋 CLI Command for Listing Prompts

Discover and explore available prompts directly from the command line, simplifying prompt management and selection.

Read more in a documentation section Command Reference

CLI Usage Examples:

# List all prompts in table format
ctx prompts:list

# Show detailed information with arguments
ctx prompts:list --detailed
# or
ctx prompts -d

# Filter prompts by tags
ctx prompts:list --tag api --tag documentation
# or
ctx prompts -t api -t documentation

# Exclude prompts with specific tags
ctx prompts:list --exclude-tag experimental
# or
ctx prompts -x experimental

# Filter prompts by ID
ctx prompts:list --id system-prompt --id user-query
# or
ctx prompts -p system-prompt -p user-query

🖥️ CLI Tool Execution

Enhance your development and testing workflow by directly executing MCP tools from the command line, offering interactive prompts and simplified argument validation.

Read more in a documentation section Command Reference

CLI Usage Example:

# List available tools
ctx tool:list

# Run a specific tool interactively
ctx tool:run lint-code

# Run with arguments provided via command line
ctx tool:run lint-code --arg path=src/MyClass.php --arg fix=true

Thank you for using CTX! Your feedback and contributions help us make this tool even better. 🎈

---

What's Changed

• GitLab Source Component by @butschster in GitLab Source Component #190
• Modular Configuration Merger System by @butschster in Modular Configuration Merger System #192
• Add prompt tagging and import filtering system by @butschster in Add prompt tagging and import filtering system #195
• MCP Tool CLI Commands by @butschster in MCP Tool CLI Commands #196

New Contributors

• @eltociear made their first contribution in docs: update README.md #188

Full Changelog: 1.25.0...1.26.0

---

This discussion was created from the release 1.26.0.