Create a project
A project in Kaizen is the home for one repo / one app. All test runs, cases, plans, defects, and dashboards live under a project.
The wizard
From the empty workspace dashboard, click Create project. The four-step wizard walks through:
1. Basics
- Name — human-readable (e.g. Acme Web)
- Slug — URL-safe, used by the CLI (
--project acme-web) - Description — optional one-liner
- Color & icon — for the project picker
2. Stack
Tell Kaizen what your test stack looks like so we can preconfigure the right adapters and dashboard tiles:
- Languages — JS, Python, Java, Ruby, .NET, Go (multi-select)
- Runners — Playwright, Pytest, JUnit, RSpec, etc.
- CI provider — GitHub Actions, GitLab CI, CircleCI, Buildkite, Jenkins, Azure Pipelines, Bitbucket
This step is purely advisory — you can ingest from anywhere later.
3. Access mode
open— anyone in the workspace can readteam— read scoped to a chosen teamproject— explicit per-user invites only
You can change this anytime in Settings → Access.
4. First upload
The wizard ends with three options for getting test data in:
- Drag a
kensho-results/folder into the browser drop zone - Copy the
kensho pushsnippet for your CLI / CI - Skip for now — start empty and upload later
After the wizard finishes you land on the project dashboard. It will be empty until your first run lands.
Project dashboard tabs
Once data starts flowing, you'll see the standard tabs:
| Tab | What it shows | |---|---| | Dashboard | High-level metrics — pass rate over time, top failing suites, mean run duration, flake count | | Test Cases | Every case ever seen across runs, filterable by suite/owner/severity/labels | | Runs | Every uploaded run (closed + open). Click in for the embedded Kensho viewer | | Test Plans | Manual + automated plan bundles | | Live Runs | Streaming pipeline output from CI | | Defects | Linked bugs grouped by case | | Flaky | Cases above your flake threshold | | Migration | Manual tests waiting to be matched against automation | | Settings | Members, access mode, integrations, tokens |
Project tokens
To upload from CI without kensho login, mint a project token under Settings → Tokens. Pass it via --token or KENSHO_TOKEN env var:
KENSHO_TOKEN=krt_xxx npx kensho push --workspace acme --project acme-web
Tokens are scoped to one project and one capability (ingest only by default).
Next: upload your first run
See Upload runs for the three supported paths.