LangSmith 리소스를 쿼리하고 관리하기위한 에이전트 최초의 CLI.

AI 코딩 에이전트 (deepagents, Claude Code, Cursor, etc.) 및 프로젝트, 추적, 실행, 데이터 세트, 증발기, 실험 및 스레드에 빠른 스크립트 가능한 액세스를 필요로 개발자를 위해 내장.

설치

설치 스크립트 (추천)

macOS/리눅스:

윈도우 (PowerShell):

업그레이드

GitHub 릴리스

GitHub 릴리스에서 플랫폼에 대한 최신 바이너리를 다운로드합니다.

인증

환경 변수로 API 키 설정:

옵션 설정 기본값:

또는 프로필에서 자격 증명을 저장:

~/.langsmith/config.json에서 라이브 프로필, 소유자 전용; CLI warns 다른 사용자가 읽을 수 있다면.

그 파일에서 API 키를 유지하려면 대신 생명을 구합니다. 옵션 정보 읽기, 또는 명령 실행, 각 시간은 프로파일을 사용한다:

langsmith auth info 활성 프로파일의 키가 나온 곳을 보여줍니다.

다른 설정은 플래그로 전달 될 수 있습니다.

빠른 시작

제품 피드백

CLI에 대한 피드백을 터미널에서 직접 제출하십시오.

--category bug], feature-request], usability] (기본값), documentation, 또는 other. 피드백 페이로드는 노트, 범주를 포함,

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