generate_ci_config

Generate CI/CD configuration files for GitHub Actions or GitLab CI from your devpipe configuration to automate pipeline execution.

Instructions

Generate CI/CD configuration file (GitHub Actions or GitLab CI) from devpipe config.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`config`	No	Path to config.toml file
`platform`	Yes	CI/CD platform to generate config for

Implementation Reference

src/index.ts:596-618 (handler)

MCP tool handler for 'generate_ci_config': locates and parses devpipe config.toml, validates platform input, generates CI config using utility function, returns as text content.

case 'generate_ci_config': {
  const configPath = args?.config || await findConfigFile();
  if (!configPath) {
    throw new Error('No config.toml file found');
  }

  const platform = args?.platform as 'github' | 'gitlab';
  if (!platform) {
    throw new Error('platform is required (github or gitlab)');
  }

  const config = await parseConfig(configPath);
  const ciConfig = generateCIConfig(config, platform);

  return {
    content: [
      {
        type: 'text',
        text: ciConfig,
      },
    ],
  };
}

src/utils.ts:627-687 (helper)

Core utility function that generates GitHub Actions or GitLab CI YAML configuration to run devpipe pipeline, including installation steps and artifact upload.

export function generateCIConfig(config: DevpipeConfig, platform: 'github' | 'gitlab'): string {
  const tasks = listTasksFromConfig(config);
  const enabledTasks = tasks.filter(t => t.enabled && !t.isPhaseHeader);

  if (platform === 'github') {
    return `name: CI Pipeline

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  devpipe:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Install devpipe
        run: |
          curl -L https://github.com/drewkhoury/devpipe/releases/latest/download/devpipe-linux-amd64 -o devpipe
          chmod +x devpipe
          sudo mv devpipe /usr/local/bin/
      
      - name: Run devpipe
        run: devpipe --fail-fast
      
      - name: Upload results
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: devpipe-results
          path: .devpipe/
`;
  } else if (platform === 'gitlab') {
    return `stages:
  - validate
  - test
  - build

devpipe:
  stage: test
  image: golang:latest
  before_script:
    - curl -L https://github.com/drewkhoury/devpipe/releases/latest/download/devpipe-linux-amd64 -o devpipe
    - chmod +x devpipe
    - mv devpipe /usr/local/bin/
  script:
    - devpipe --fail-fast
  artifacts:
    when: always
    paths:
      - .devpipe/
    reports:
      junit: .devpipe/runs/*/metrics/*.xml
`;
  }

  return '';
}

src/index.ts:275-292 (registration)

Tool registration in ListTools handler defining name, description, and input schema for generate_ci_config.

  name: 'generate_ci_config',
  description: 'Generate CI/CD configuration file (GitHub Actions or GitLab CI) from devpipe config.',
  inputSchema: {
    type: 'object',
    properties: {
      config: {
        type: 'string',
        description: 'Path to config.toml file',
      },
      platform: {
        type: 'string',
        enum: ['github', 'gitlab'],
        description: 'CI/CD platform to generate config for',
      },
    },
    required: ['platform'],
  },
},

src/index.ts:277-290 (schema)

Input schema defining parameters: config (optional string path), platform (required enum: github/gitlab).

inputSchema: {
  type: 'object',
  properties: {
    config: {
      type: 'string',
      description: 'Path to config.toml file',
    },
    platform: {
      type: 'string',
      enum: ['github', 'gitlab'],
      description: 'CI/CD platform to generate config for',
    },
  },
  required: ['platform'],

Devpipe MCP Server