Frontier Tuning CLI quick reference (preview)

This article lists the most common Frontier Tuning CLI commands by task. Both frontier-tuning and the shorter alias ftune invoke the same CLI. For every command and option, see the full Frontier Tuning CLI documentation, or run any command with --help.

Important

Frontier Tuning is in public preview. Commands and options can change between CLI versions. This reference reflects CLI version 1.0.21.

Global options

Option Description
-e, --env-id <env-id> Run the command against a specific tuning environment instead of the saved default.
-o json Return machine-readable JSON output.
-v Show verbose diagnostics.
--help Show a command's options.
-y, --yes Skip a confirmation prompt. Required, with an explicit -e, for destructive commands in automation.

Install, sign in, and update

Task Command
Install on Windows (PowerShell) irm https://aka.ms/ft-cli/v1/ps1 \| iex
Install on macOS, Linux, or Windows Subsystem for Linux (WSL) curl -fsSL https://aka.ms/ft-cli/v1/sh \| bash
Show the installed version frontier-tuning --version
Sign in frontier-tuning auth login
Sign in with a different account frontier-tuning auth login --interactive
Check sign-in and access frontier-tuning auth check
Show the signed-in identity frontier-tuning auth whoami
Sign out frontier-tuning auth logout
Show the saved configuration frontier-tuning config show
Check for or apply an update frontier-tuning update --check, frontier-tuning update
Turn off automatic updates frontier-tuning config set auto_update false

Tuning environments (environments)

Task Command
Create a tuning environment frontier-tuning environments create --name "<name>" --description "<text>"
Generate a tuning environment Markdown template frontier-tuning environments init-md --out-file env.md
List prebuilt templates frontier-tuning environments templates list
Create a tuning environment from a template frontier-tuning environments create --name "<name>" --template-id <template-id>
Resume template setup frontier-tuning environments apply-template
List tuning environments frontier-tuning environments list
Show a tuning environment frontier-tuning environments get <env-id>
Update a tuning environment's name or description frontier-tuning environments update --name "<name>"
Export a tuning environment frontier-tuning environments export <env-id> --out-file <file>
Import into a new tuning environment frontier-tuning environments import --file <file>
Browse artifacts frontier-tuning environments artifacts list
Delete a tuning environment frontier-tuning environments delete <env-id>

Access and experts

Task Command
List access frontier-tuning environments access list
Grant a role frontier-tuning environments access grant <upn> --role contributor
Revoke access frontier-tuning environments access revoke <upn>
Prepare a subject-matter expert (SME) invitation frontier-tuning environments invitations prepare --file request.json --operation-file invitation.json --tenant-id <tenant-id> --caller-id <object-id>
Send a prepared invitation frontier-tuning environments invitations submit --operation-file invitation.json
Check an invitation frontier-tuning environments invitations get --operation-file invitation.json
Transcribe a video frontier-tuning recordings transcripts start --video-url <url>
Extract a workflow from a recording frontier-tuning recordings workflows start --folder-url <url>

Knowledge and tools

Task Command
Add a SharePoint site frontier-tuning knowledge add --type site --site-url <url>
Add a file by URL frontier-tuning knowledge add --type file --file-url <url>
List knowledge sources frontier-tuning knowledge list
Build a search index frontier-tuning index create --model cohere-embed-v4
Find connectors frontier-tuning tools discover
Inspect a connector frontier-tuning tools get <connector-id>
Enable or disable a connector frontier-tuning tools enable <connector-id>, frontier-tuning tools disable <connector-id>
Sign in to a connector frontier-tuning tools connect <connector-id>
Add a connector instance frontier-tuning tools instances add <connector-id> --name "<name>" --param <name>=<value>
Choose a connector's stages frontier-tuning tools update <connector-id> --label Inference --label Evaluation
Remove a connector frontier-tuning tools delete <connector-id>

Skills and evaluation criteria

In CLI commands, evaluation criteria are called rubrics.

Task Command
Create a skill frontier-tuning skills create --name <name> --description <text> --prompt <text>
Generate a skill Markdown template frontier-tuning skills init-md --out-file my-skill.md
Create a skill from a file frontier-tuning skills create --file my-skill.md
List skills frontier-tuning skills list
Suggest skills from Microsoft 365 activity frontier-tuning skills suggest
Improve a skill's instructions frontier-tuning skills enrich <skill-id>
Update a skill frontier-tuning skills update <skill-id> --prompt "<text>"
Restore an earlier version frontier-tuning skills versions rollback <skill-id> <version-id>
Generate evaluation criteria frontier-tuning skills generate-rubrics <skill-id>
List evaluation criteria frontier-tuning rubrics list --skill-id <skill-id>
Update an evaluation criterion frontier-tuning rubrics update <rubric-id> --skill-id <skill-id> --importance high
Refine a skill and its evaluation criteria frontier-tuning skills refine start --skill-id <skill-id> --mode both
Apply a refinement frontier-tuning skills refine apply <refinement-id>

Samples

Task Command
Create a sample frontier-tuning samples create --prompt "<text>" --skill-id <skill-id> --type Evaluation
Upload samples frontier-tuning samples upload <file> --skill-id <skill-id> --type Training
Suggest samples frontier-tuning samples suggest --skill-id <skill-id>
Generate synthetic samples frontier-tuning samples generations start --skill-id <skill-id>
Change a sample's label frontier-tuning samples update <sample-id> --type Training
List samples frontier-tuning samples list

Run, evaluate, and tune

Task Command
Send a request frontier-tuning executions run -q "<request>" --wait
List models frontier-tuning models list
Evaluate (smoke test) frontier-tuning evaluate start --skill-id <skill-id> --limit 1
Evaluate models separately frontier-tuning evaluate start --base-model <model-a> --base-model <model-b> --per-model
Compare inference strategies frontier-tuning evaluate start --strategy TreeSearch
Show evaluation results frontier-tuning evaluate results <job-id> --samples
Compare evaluation jobs frontier-tuning evaluate compare <job-a> <job-b>
Fine-tune a model frontier-tuning tune start --base-model <model> --new-model <name>
Check a tuning job frontier-tuning tune status <job-id>
Enable a model for inference frontier-tuning models set <model-id>
Delete a deployed tuned model frontier-tuning models delete <model-id>

Publish, serve, and monitor

Task Command
Publish a tuning environment as a Microsoft 365 agent frontier-tuning environments publish
Publish a skill frontier-tuning skills publish <skill-id>
Serve a tuning environment to Model Context Protocol (MCP) clients frontier-tuning -e <env-id> serve stdio
Check asset quality frontier-tuning health quality check
Review daily activity frontier-tuning health insights
Show active users frontier-tuning health statistics