Quick start#

Installation#

conda install -c conda-forge conda-tasks

pixi global install conda-tasks

Your first task file#

Create a conda.toml in your project root:

[tasks]
hello = { cmd = "echo Hello from conda-tasks!", description = "A simple hello world task" }

Run it:

conda task run hello

Task dependencies#

Tasks can depend on other tasks:

[tasks]
compile = { cmd = "gcc -o main main.c", description = "Compile the program" }
test = { cmd = "./main --test", depends-on = ["compile"], description = "Run tests" }

Running conda task run test will first run compile, then test.

Listing tasks#

conda task list

Supported file formats#

conda-tasks automatically detects task definitions from these files (in order):

  1. pixi.toml – reads the [tasks] table directly

  2. conda.toml – canonical TOML format (same structure as pixi.toml)

  3. pyproject.toml – reads [tool.conda.tasks], [tool.conda-tasks.tasks], or [tool.pixi.tasks]

  4. .condarc – reads plugins.conda_tasks.tasks (via conda’s settings API)

Running in a specific environment#

conda task run test -n myenv

This activates myenv before running the task, just like conda run -n myenv.

Next steps#

Your first project

A full walkthrough: build, test, lint, cache, and platform overrides.

Your first project with conda-tasks
Coming from pixi?

What’s the same, what’s different, and how to migrate.

Coming from pixi