sentry-for-ai - GitLite

KO | EN

gitlite — search

#javascript #python #react #go #rust #nodejs #java #awesome-list #pytorch #security #mcp #ios #openai #open-source

sentry-for-ai

(★ 252)

Teach your AI coding assistant how to use Sentry - setup, debugging, alerts, and more

파일 탐색기

최종 버전 다운로드 (.zip)

- settings.json
- - skill-creator.agent.md
  - skill-updater.agent.md
- - actions-lock.json
- - deploy-plugins.yml
  - lint.yml
  - release-build.yml
  - release-plugins.yml
  - release.yml
  - skill-drift.yml
  - smoke-installer.yml
- CODEOWNERS
- skill-drift-matrix.json
- logo-small.svg
- logo.svg
- - .gitignore
  - .oxfmtrc.json
  - CHANGELOG.md
  - LICENSE
  - package.json
  - README.md
  - rolldown.config.mjs
  - tsconfig.json
- build-common.sh
- build-skill-tree.sh
- bump-version.sh
- dev-version.sh
- gen-semantics.py
- hydrate-references.py
- lint.sh
- validate-built-links.sh
- validate-skill-links.py
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - version.json
- - auth-token.md
  - first-error-setup.md
  - new-project.md
  - search-query-language.md
  - setup-verification.md
- SKILL_TREE.md
.craft.yml
.flowmarkignore
.gitattributes
.gitignore
.pre-commit-config.yaml
AGENTS.md
CLAUDE.md
LICENSE
mcp.json
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
TELEMETRY.md
warden.toml

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/getsentry/sentry-for-ai

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd sentry-for-ai

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.

brew install gh # macOS

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Sentry for AI

> [!IMPORTANT]
> **This is a skill *source* repository — not something you install directly.** The
> skills here are built from this source into a portable
> [Agent Plugin](https://github.com/getsentry/agent-plugin) and installable
> client-specific plugins for [Claude Code](https://github.com/getsentry/plugin-claude),
> [Cursor](https://github.com/getsentry/plugin-cursor),
> [Codex](https://github.com/getsentry/plugin-codex), and
> [Grok](https://github.com/getsentry/plugin-grok) — install one of those, not this
> repo. They’re also served over HTTP at [skills.sentry.dev](https://skills.sentry.dev)
> for agents to fetch directly.
> In the future we may also publish the skills as a generic, standalone skills
> repository.

Your AI coding assistant already knows how to write code.
This plugin teaches it Sentry — how to set it up, how to find and fix production issues,
and how to get the most out of every feature.

Whether you’re adding Sentry to a new project, debugging a spike in errors, or
configuring alerts, just ask.
The plugin gives your assistant the context it needs to do it right.

Supports the [**Agent Plugins standard**](https://agent-plugins.org/),
[**Claude Code**](https://github.com/getsentry/plugin-claude),
[**Cursor**](https://github.com/getsentry/plugin-cursor),
[**Codex**](https://github.com/getsentry/plugin-codex), and
[**Grok**](https://github.com/getsentry/plugin-grok).

## What You Can Do

**Set up Sentry in any project** — SDK setup wizards that detect your stack, recommend
the right features, and walk through the full installation.
No copy-pasting from docs.

```
Add Sentry to my Next.js app
Set up Sentry in my Rails project
Add error monitoring to my iOS app
```

**Find and fix production issues** — Query your Sentry environment, triage errors, and
fix them in place.

```
What are the top errors in the last 24 hours?
Which issues are affecting the most users?
Fix the recent Sentry errors
```

**Review code with Sentry context** — Automatically resolve bugs that Sentry or Seer
flag in pull request comments.

```
Review PR #118 and fix the Sentry comments
```

**Configure monitoring** — Set up alerts, instrument AI/LLM calls, connect OpenTelemetry
pipelines.

```
Create a Slack alert for new high-priority issues
Monitor my OpenAI calls with Sentry
Set up OTel Collector with Sentry exporter
```

## Distribution

This repository is the single source of truth for all skills, but it is not itself an
installable plugin.
Each assistant needs the plugin in a slightly different shape, so the
per-agent plugins are **built** from it by the build scripts under
`src/plugins/<agent>/build.sh`. CI runs these on every push and deploys each result to
its own **distribution repository**, whose root is exactly that agent’s plugin:

| Agent | Distribution repository |
| --- | --- |
| Agent Plugins 1.0.0 | [`getsentry/agent-plugin`](https://github.com/getsentry/agent-plugin) |
| Claude Code | [`getsentry/plugin-claude`](https://github.com/getsentry/plugin-claude) |
| Cursor | [`getsentry/plugin-cursor`](https://github.com/getsentry/plugin-cursor) |
| Codex | [`getsentry/plugin-codex`](https://github.com/getsentry/plugin-codex) |
| Grok | [`getsentry/plugin-grok`](https://github.com/getsentry/plugin-grok) |

These repositories are generated; do not edit them.
Each one’s README has the install instructions for that agent.

The skill library is also browsable at [skills.sentry.dev](https://skills.sentry.dev)
and available through the [`skills.sh`](https://www.skills.sh/getsentry/sentry-for-ai)
installer.

### Build it yourself

Each `src/plugins/<agent>/build.sh` takes an output directory and writes that agent’s
plugin into it (the Codex build moves the plugin under `plugins/sentry/` and swaps the
skill tree’s `disable-model-invocation` flags for Codex’s `agents/openai.yaml` policy):

```bash
git clone https://github.com/getsentry/sentry-for-ai.git
cd sentry-for-ai
src/plugins/agent-plugin/build.sh /tmp/sentry-agent-plugin
```

To build any target locally, run `src/plugins/<agent>/build.sh <output-dir>`
(`agent-plugin`, `claude`, `cursor`, `codex`, or `grok`).

## Skills

### Core

| Skill | What it does |
| --- | --- |
| `sentry-get-started` | Guided entry point — orients to your current Sentry setup and routes to the right skill |
| `sentry-instrument` | Add Sentry to a project, or wire up any signal — error monitoring, tracing, logging, metrics, profiling, session replay, user feedback, cron check-ins, and AI/LLM monitoring. Detects your platform and pulls the code from the reference library. |
| `sentry-debug-issue` | Find a Sentry issue, pull full context, optionally run Seer root-cause / autofix, apply the fix, and resolve it |

### Feature Setup

| Skill | What it does |
| --- | --- |
| `sentry-otel-exporter-setup` | Configure OTel Collector with the Sentry exporter for multi-project routing |
| `sentry-create-alert` | Create alerts via the Sentry workflow engine API |
| `sentry-snapshots-cocoa` | Set up Sentry Snapshots for Apple/Cocoa projects |

### Reference Library

`sentry-instrument` doesn’t hard-code platform steps — it pulls them from a shared
library that the build hydrates into the skill:

- **`src/references/sdks/<platform>/`** — per-platform install and per-signal code, one
  directory per supported platform.
- **`src/references/concepts/`** — per-signal strategy: errors, tracing, logging,
  metrics, profiling, session replay, user feedback, crons, releases, data scrubbing,
  and choosing-a-signal.

> Superseded per-SDK “wizard” skills are frozen under `skills-legacy/`, excluded from
> the plugin build.

## Prerequisites

The plugin configures the [Sentry MCP server](https://mcp.sentry.dev) automatically on
install. No extra setup needed.

Some skills require the [GitHub CLI](https://cli.github.com/):

```bash
brew install gh    # macOS
gh auth login
```

## Contributing

Skills follow the [Agent Skills specification](https://agentskills.io).
Each skill is a directory with a `SKILL.md` file containing YAML frontmatter and
markdown instructions.
A skill can declare the shared references it needs in a `references.yml` manifest; the
build hydrates the matching files from the shared library at `references/` into the
skill so the shipped copy is self-contained.

## License

MIT