@glitchtip/cli

中文文档
1.0.0发布于 2026/05/23MIT零依赖近 30 天下载 1.4万

Open source CLI for GlitchTip

原始使用文档
文档目录8 节
  1. Installation
  2. Usage
  3. Configuration
  4. Supported commands
  5. Not yet supported
  6. Not planned
  7. GlitchTip-specific
  8. License

GlitchTip CLI

Open source CLI for GlitchTip.

Installation

Download a binary from the releases page or build from source:

cargo install --path .

This installs the glitchtip-cli binary.

Usage

# Configure
glitchtip-cli --url https://your-glitchtip-instance.com login

# Upload sourcemaps
glitchtip-cli sourcemaps upload --release 1.0.0 ./dist

# Manage releases
glitchtip-cli releases list
glitchtip-cli releases new 1.0.0
glitchtip-cli releases finalize 1.0.0
glitchtip-cli releases set-commits 1.0.0 --auto

# Create deploys
glitchtip-cli deploys --release 1.0.0 new -e production

# Send a test event (uses SENTRY_DSN)
glitchtip-cli send-event -m "deploy verification" -l info -E production

Configuration

Configuration is loaded in this order (highest priority first):

  1. CLI flags (--url, --auth-token, --org, --project)
  2. Environment variables (SENTRY_URL, SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT, SENTRY_DSN)
  3. Local config file (.sentryclirc or .glitchtip-cli.rc, searched upward from cwd)
  4. Global config (~/.config/glitchtip-cli/config, ~/.config/sentry/sentrycli.ini, or ~/.sentryclirc)

Config files use INI format:

[auth]
token=sntrys_xxx
dsn=https://[email protected]/1

[defaults]
url=https://your-glitchtip-instance.com
org=my-org
project=my-project

Supported commands

CommandStatusNotes
loginSupportedInteractive token setup
infoSupportedConfig and auth status display
releases newSupported
releases finalizeSupported
releases listSupported
releases deleteSupported
releases set-commitsSupported--auto for git discovery
sourcemaps uploadSupportedChunked upload with gzip
sourcemaps injectSupportedInject debug IDs into source files and sourcemaps
sourcemaps resolveSupportedResolve sourcemap for a given line/column position
deploys newSupported
deploys listSupported
send-eventSupportedDSN auth, envelope protocol
organizations listSupported
projects listSupported
repos listSupported
releases propose-versionSupported
releases infoSupportedVersion, date, projects, commits
releases archiveSupported
releases restoreSupported
issues listSupported
issues resolveSupportedBulk resolve by ID, status, or all
issues muteSupportedBulk mute (ignore) issues
issues unresolveSupportedBulk unresolve issues
send-envelopeSupportedSend a pre-built envelope file
events listSupportedWith --show-user and --show-tags
monitors listSupportedList uptime monitors
monitors createSupportedCreate an uptime monitor
monitors deleteSupportedDelete an uptime monitor
monitors runSupportedRun a command and send heartbeat on success
logs listSupportedList and filter OpenTelemetry log entries
debug-files checkSupportedCheck debug info file for usability
debug-files uploadSupportedUpload debug information files (ELF/dSYM/PDB/etc.)
debug-files findSupportedLocate debug files by debug ID
debug-files print-sourcesSupportedPrint source references in a debug file
debug-files bundle-sourcesSupportedCreate source bundles from debug info files
debug-files bundle-jvmSupportedCreate source bundles from Java/Kotlin sources
dart-symbol-map uploadSupportedUpload Dart/Flutter symbol maps for deobfuscation

Not yet supported

These commands are not yet implemented, listed roughly in order of priority.

CommandNotes
react-native gradleUpload sourcemaps from Android gradle builds

Not planned

These commands are out of scope, either because they are niche, deprecated, or involve platform-specific toolchains.

CommandReason
react-native xcodemacOS-only
react-native appcenterDeprecated
bash-hookShell error hook; rarely used in practice
send-metricDeprecated
update / uninstallPackage manager territory
sourcemaps explainDeprecated
filesDeprecated; use sourcemaps upload
upload-dif / upload-dsym / upload-proguardHidden aliases for debug-files upload
build uploadNiche build artifact management

GlitchTip-specific

Features unique to GlitchTip that we plan to add CLI support for.

FeatureNotes
logs list --live (streaming)WebSocket-based live log streaming

License

MIT

版本与发布记录

@glitchtip/cli 共发布 1 个版本,首次发布于 2026/05/23;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.0.0latest2026/05/235 个月前

关于 @glitchtip/cli 的常见问题

@glitchtip/cli 是什么?

Open source CLI for GlitchTip

如何安装 @glitchtip/cli?

在项目目录运行 npm install @glitchtip/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 glitchtip-cli,可以用 npx glitchtip-cli 直接运行。

@glitchtip/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/glitchtip__cli 是否存在。

@glitchtip/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@glitchtip/cli 可以商用吗?

@glitchtip/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@glitchtip/cli 的下载量有多少?

根据 npm 官方下载统计,@glitchtip/cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 14,215 次,日均约 474 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@glitchtip/cli 还在维护吗?

最新版本 1.0.0 发布于 2026/05/23(5 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/05/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。