Агент CLI для запроса и управления ресурсами LangSmith.

Создан для агентов кодирования ИИ (deepagents, Claude Code, Cursor и т. д.) и разработчиков, которым нужен быстрый доступ к проектам, трассам, запускам, наборам данных, оценщикам, экспериментам и потокам.

##Установка

###Сценарий установки (рекомендуется)

macOS/Linux:

Windows (PowerShell):

###Обновление

GitHub скачать

Загрузите последний двоичный файл для вашей платформы из GitHub Releases.

Аутентификация

Установите ключ API в качестве переменной среды:

Опционально установленные по умолчанию:

Или сохраните учетные данные в профиле:

Написано только в том виде, в каком оно есть, и только в том виде, в каком оно есть. Если он читается другими пользователями.

Чтобы сохранить ключ API из этого файла, сохраните его там, где он живет. переменная читается или запускается команда каждый раз, когда используется профиль:

T1 показывает, откуда берется ключ активного профиля.

Другие настройки могут быть переданы как флаги:

Быстрый старт

##Отзывы о продукте

Отправьте отзывы о CLI непосредственно с терминала:

[[Т2]] принимает [[Т3]], [[Т4]], [[Т5]] (по умолчанию), [6] или [7]. Полезная нагрузка обратной связи содержит примечание, категорию,

langsmith-cli

An agent-first CLI for querying and managing LangSmith resources.

Built for AI coding agents (deepagents, Claude Code, Cursor, etc.) and developers who need fast, scriptable access to projects, traces, runs, datasets, evaluators, experiments, and threads.

Installation

Install script (recommended)

macOS / Linux:

curl -fsSL https://cli.langsmith.com/install.sh | sh

Windows (PowerShell):

irm https://cli.langsmith.com/install.ps1 | iex

Upgrade

langsmith self-update

GitHub releases

Download the latest binary for your platform from GitHub Releases.

Authentication

Set your API key as an environment variable:

export LANGSMITH_API_KEY="lsv2_pt_..."

Optionally set defaults:

export LANGSMITH_ENDPOINT="https://api.smith.langchain.com"  # For self-hosted
export LANGSMITH_WORKSPACE_ID=""                # Default workspace
export LANGSMITH_PROJECT="my-default-project"                 # Default project for queries

Or save the credentials in a profile:

langsmith auth login                    # OAuth
langsmith auth signup                   # Create an account in the browser, then log in to it
langsmith profiles create prod           # API key, taken from $LANGSMITH_API_KEY

Profiles live in ~/.langsmith/config.json, written owner-only; the CLI warns if it is readable by other users.

To keep an API key out of that file, save where it lives instead. The variable is read, or the command run, each time the profile is used:

langsmith profiles create prod --api-key-env PROD_LANGSMITH_API_KEY
langsmith profiles create prod --api-key-cmd 'op read "op://Private/LangSmith/credential"'

langsmith auth info shows where the active profile’s key comes from.

Other settings can be passed as flags:

langsmith --workspace  trace list --project my-app

Quick Start

# List tracing projects
langsmith projects list

# List recent traces in a project
langsmith traces list --project my-app --limit 5

# Get a specific trace with full detail
langsmith traces get  --project my-app --full

# List LLM calls with token counts
langsmith runs list --project my-app --run-type llm --include-metadata

# List datasets
langsmith datasets list

# List experiments for a dataset
langsmith experiments list --dataset my-eval-set

Product feedback

Submit feedback about the CLI directly from the terminal:

langsmith report "Trace output is hard to scan"
langsmith report --category bug "The command fails on Windows"

--category accepts bug, feature-request, usability (the default), documentation, or other. The feedback payload contains the note, category, CLI version, operating system, architecture, and a fixed CLI source value. It