joerdav/xc

Health v2 · maintenance only

Adoption not part of the score

1408 stars · 36 forks observed · 2026-10-18

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

xc is a task runner similar to Make or npm run that defines tasks as shell code blocks inside Markdown or org-mode documentation files, keeping scripts and docs in sync. It is written in Go and offers editor integrations for VSCode, Vim, and Emacs.

Use cases

• run project tasks defined in my readme
• alternative to makefile that lives in documentation
• keep shell scripts in sync with docs
• define build commands as markdown code blocks
• list and run tasks from README.md
• org-mode based task runner
• share project commands with contributors without extra tooling

When to choose

• you want task definitions and documentation in a single Markdown or org-mode file
• your team already documents commands in a README and wants them executable
• you prefer a simple, low-complexity task runner over Make
• contributors without xc installed can still read the commands

When to avoid

• you need complex build dependency graphs or incremental builds
• your tasks require advanced Make features like file targets or pattern rules
• you prefer task definitions in dedicated config files like package.json or Taskfile

Facets

cli-tool · maturity active

build-tool cli documentation markdown developer-tools developer-tools documentation windows cli cross-platform task-runner literate-programming org-mode makefile-alternative readme-driven command-line automation linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="joerdav/xc")