sentry-tui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Billy Vong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# sentry-tui
+
+sentry.io in your terminal — a TUI client built with [OpenTUI](https://opentui.com),
+mirroring Sentry's real information architecture and screen layouts.
+
+## Status
+
+Hackweek 2026. The Issues path is built end to end; other nav sections are
+honest stubs.
+
+- [x] Phase 1 — app shell, focus ring, theme, command catalog
+- [x] Phase 2 — API client, auth, domain types
+- [x] Phase 2.5 — loading states
+- [x] Phase 3 — issue stream
+- [x] Phase 4 — issue detail + stack traces
+- [x] Phase 5 — triage actions
+- [x] Phase 6 — OAuth device-flow login
+
+Next: command palette, org/project switcher, and the remaining nav sections.
+
+## Install
+
+Every route below installs the same self-contained binary — no Bun, Node, or
+npm needed at runtime.
+
+```bash
+# Homebrew
+brew install billyvg/tap/sentry-tui
+
+# Shell installer → ~/.local/bin (set SENTRY_TUI_INSTALL_DIR to change that)
+curl -fsSL https://raw.githubusercontent.com/billyvg/sentry-tui/main/install.sh | bash
+
+# npm — one-off, or installed globally
+npx sentry-tui
+npm install -g sentry-tui
+```
+
+`sentry-tui` and `@billyvg/sentry-tui` are the same package; the platform
+binary arrives as an optional dependency, so you download one binary rather
+than four. Binaries are also attached to every
+[release](https://github.com/billyvg/sentry-tui/releases).
+
+Supported: macOS and Linux, on arm64 and x64. Windows and musl-based Linux
+(Alpine) aren't built — run from source there.
+
+### From source
+
+Running from source needs **Bun ≥ 1.3.0**. OpenTUI reaches its native renderer
+through `bun:ffi`; the Node backend wants `node:ffi`, which is Node 26.1+ behind
+`--experimental-ffi`, so Bun is the supported path.
+
+```bash
+git clone https://github.com/billyvg/sentry-tui
+cd sentry-tui
+bun install
+bun start
+```
+
+## Authentication
+
+```bash
+sentry-tui login     # OAuth device flow — opens your browser
+sentry-tui status    # who you're signed in as, and for how long
+sentry-tui logout    # forget the stored credentials
+```
+
+`login` prints a short code, opens <https://sentry.io/oauth/device/>, and waits
+for you to approve it (RFC 8628). Starting the TUI with no credentials offers
+the same flow. Access tokens are renewed automatically; Sentry rotates the
+refresh token on each renewal, so the new pair is written back immediately.
+
+Use `--no-browser` to print the URL instead of opening one, and `SENTRY_URL` +
+`SENTRY_CLIENT_ID` to log in to a self-hosted install (needs Sentry ≥ 26.1.0 and
+a **public** OAuth application from Settings → Account → API → Applications).
+
+### Personal token instead
+
+Create one at <https://sentry.io/settings/account/api/auth-tokens/> with these
+scopes — the same set `login` requests:
+
+```
+org:read  project:read  event:read  event:write  member:read  team:read
+```
+
+```bash
+export SENTRY_AUTH_TOKEN=sntryu_…
+```
+
+Resolution order is `SENTRY_AUTH_TOKEN` → `SENTRY_TOKEN` → the credential file.
+Environment tokens are used exactly as given and never refreshed.
+
+### Files
+
+| Path                                    | Holds                                           |
+| --------------------------------------- | ----------------------------------------------- |
+| `~/.config/sentry-tui/config.json`      | preferences (default org), rewritten by the app |
+| `~/.config/sentry-tui/credentials.json` | tokens, written `0600`                          |
+
+Secrets live apart from the file the app has to keep writable. A token left in
+`config.json` by an older build is moved across on the next run.
+
+## Development
+
+```bash
+bun run dev        # watch mode
+bun test           # test suite
+bun run typecheck  # tsc --noEmit
+```
+
+Set `SENTRY_TUI_LATENCY=3000` to inject artificial API latency and exercise
+loading states.
+
+## Keys
+
+`?` for the full list. The basics: `j`/`k` move, `tab` switches pane,
+`enter` opens, `r` resolves, `a` archives, `q` quits.

package/bin/sentry-tui.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Bin entry for the unscoped `sentry-tui` alias, which exists so that
+// `npx sentry-tui` works. All it does is hand off to the real package.
+import { main } from "@billyvg/sentry-tui/launch";
+
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "description": "sentry.io in your terminal — a TUI client for Sentry",
+  "license": "MIT",
+  "author": "Billy Vong",
+  "homepage": "https://github.com/billyvg/sentry-tui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/billyvg/sentry-tui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/billyvg/sentry-tui/issues"
+  },
+  "name": "sentry-tui",
+  "version": "0.1.0",
+  "keywords": [
+    "sentry",
+    "tui",
+    "terminal",
+    "cli",
+    "errors",
+    "observability",
+    "opentui"
+  ],
+  "type": "module",
+  "bin": {
+    "sentry-tui": "bin/sentry-tui.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@billyvg/sentry-tui": "0.1.0"
+  }
+}