Skip to content

Add insights to Commands Overview section for CLI docs #3430

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Jake Broekhuizen (j-broekhuizen) wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add insights to Commands Overview section for CLI docs #3430

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion src/langsmith/langsmith-cli.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: LangSmith CLI
sidebarTitle: CLI
icon: terminal-2
description: Query and manage LangSmith projects, traces, runs, datasets, evaluators, experiments, and threads from the terminal
description: Query and manage LangSmith projects, traces, runs, datasets, evaluators, experiments, insights, and threads from the terminal
---

The LangSmith CLI is a fast, agent-friendly command-line tool for working with your LangSmith data and workflows directly from the terminal. It’s designed for both humans and AI coding agents to list, filter, retrieve, and export data—with predictable JSON output by default and a pretty table mode for humans.
Expand Down Expand Up @@ -153,3 +153,14 @@ langsmith evaluator delete accuracy --yes
langsmith experiment list --dataset my-eval-set
langsmith experiment get my-experiment-2024-01-15
```

### insights—view trace analysis reports

The [Insights Agent](/langsmith/insights) automatically clusters and analyzes your traces to surface usage patterns, failure modes, and key findings. Use these commands to list and retrieve completed reports.

```bash
langsmith insights list --project my-app
langsmith insights list --project my-app --limit 5 --format pretty
langsmith insights get <insight-id> --project my-app
langsmith insights get <insight-id> --project my-app --format pretty
```
Loading