Home / Documentation / traceloom init
Documentation

Getting Started

CLI

Infrastructure

Community

traceloom init

Initialize a TraceLoom project in the current directory. Creates a .traceloom.yml config file so you can run traceloom run without passing flags every time.

Usage

traceloom init

What it does

Running traceloom init prompts you for:

  1. Your customer ID — found in the TraceLoom dashboard under Settings
  2. Your project ID — the project you want test runs attributed to
  3. An optional API URL — leave blank to use the default https://api.traceloom.io

After answering the prompts, a .traceloom.yml file is created in the current directory.

Generated config file

customer: your-customer-id
project: your-project-id
apiUrl: https://api.traceloom.io   # optional

See the Config File section on the CLI overview page for the full field reference and config resolution order.

Next Steps

  • traceloom run — submit your Playwright tests for distributed execution
  • traceloom auth — authenticate with your API key first if you haven't already
  • CLI Overview — see all available commands

Last updated: April 2026

>