Installation

Install the CLI

Installation of the vally CLI is easy - just use NPM:

npm install -g @microsoft/vally-cli

Verify installation

vally --version

You should see the version number printed. If you used npx, prefix all commands with npx:

npx vally --version

Use as a library

If you want to use Vally programmatically (custom graders, pipeline integration), install the core package:

npm install @microsoft/vally

Then import what you need:

import { discoverSkills, runLint, runEval, gradeTrajectory } from "@microsoft/vally";

Tip

The CLI is a thin wrapper around the core library. Anything the CLI can do, you can do programmatically with more control.

What’s included

Package	Description
@microsoft/vally	Core library — discovery, parsing, grading, scoring
@microsoft/vally-cli	Command-line tool — lint, eval, grade

Next steps

• Run your first eval — execute an agent and grade the results
• How it works — understand the pipeline model