Convert .gitlab-ci.yml to CircleCI 2.1 config.yml. Translates stages, jobs, parallel matrix, cache, artifacts, and rules. Side-by-side diff, audit log, no upload.
GitLab's `stages` plus `needs` model maps cleanly to CircleCI's `workflows.<name>.jobs` graph. The converter walks every GitLab job, picks an equivalent Docker executor (defaulting to `cimg/base:stable` if no explicit `image:` was set), and rewrites `script` lines as CircleCI `run` steps. Cache and artifact handling change shape: GitLab's job-level `cache:` block becomes a `restore_cache` + `save_cache` pair, and GitLab's `artifacts:` block becomes `store_artifacts` plus `persist_to_workspace` so downstream jobs can attach.
| Concept | GitLab CI | CircleCI |
|---|---|---|
| Stage / job order | stages: [test, deploy] test: stage: test | workflows: main: jobs: - test - deploy: requires: [test] |
| Image | image: node:20 | docker: [{ image: cimg/node:20 }] |
| Variable expansion | $CI_COMMIT_REF_NAME | << pipeline.git.branch >> |
| Cache | cache: key: foo paths: [node_modules] | - restore_cache: { keys: [foo] } - save_cache: { key: foo, paths: [node_modules] } |
| Artifact | artifacts: paths: [dist] | - store_artifacts: { path: dist } - persist_to_workspace: { root: ., paths: [dist] } |
Pick a real executor image
The default `cimg/base:stable` runs your scripts but lacks language toolchains. Replace it with `cimg/node:20`, `cimg/python:3.11`, etc., for faster cold starts.
Rules → filters
GitLab `rules:` translate to CircleCI `filters:` (branches/tags) on the workflow job entry. Step-level rules disappear and become bash conditionals.
parallel:matrix → workflow matrix
GitLab `parallel: matrix:` becomes CircleCI `matrix.parameters:` on the workflow job. Each job parameter must be referenced via `<< parameters.foo >>` inside the job.
before_script becomes prefix steps
GitLab `before_script:` lines are inserted at the top of the job's `steps:` list, before the converted `script:` lines.
Single stage, single job. Default Docker executor.
stages:
- test
test:
stage: test
image: node:20
script:
- npm ci
- npm testversion: 2.1
jobs:
test:
docker:
- image: node:20
steps:
- checkout
- run: npm ci
- run: npm test
workflows:
main:
jobs: [test]No. Flatten your YAML before converting.
`tags:` becomes a comment in the CircleCI output, since CircleCI uses resource classes rather than tags. Pick the appropriate `resource_class:` after conversion.
Yes — common `$CI_*` variables are rewritten to CircleCI `<< pipeline.* >>` references. Less common ones are flagged for manual review.
YAML Formatter
Format and validate YAML. Convert YAML to JSON or JSON to YAML. Supports 2 and 4 space indentation.
Cron Builder
Visual builder for cron-job schedules.
Gitignore Generator
Generate .gitignore files for any language, framework, or IDE — 100+ templates, 100% client-side.
JSON Schema Generator
Generate a JSON Schema from one or more sample JSONs — drafts 2020-12, 2019-09, 7, 6, 4. Detects formats (date-time, email, uuid, ipv4, uri), extracts $defs, validates with AJV, and exports to YAML, TypeScript, and Zod. 100% in your browser.
AI Coding Rules
Curated rules-file library and generator for Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, Aider, Continue, and Cody. Browse 20 hand-crafted .cursorrules / CLAUDE.md / copilot-instructions.md files for popular stacks, build a custom one with the wizard, or convert any rules file between AI-tool formats.
lockYour YAML stays in your browser — nothing is uploaded. Share links use the URL fragment, which is never sent to a server.