opencode-discord-presence 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 opencode-discord-presence contributors
+
+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.ko.md

@@ -0,0 +1,183 @@
+# opencode-discord-presence
+
+[![npm version](https://img.shields.io/npm/v/opencode-discord-presence.svg)](https://www.npmjs.com/package/opencode-discord-presence)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+OpenCode 세션 상태를 Discord Rich Presence로 표시합니다. 현재 사용 중인 AI 에이전트, 모델, 세션 시간 등을 Discord에서 확인할 수 있습니다.
+
+## 기능
+
+- **실시간 에이전트 표시** - 현재 사용 중인 AI 에이전트 (Claude, Prometheus 등) 표시
+- **모델 정보** - 활성 모델 표시 (Claude Sonnet, GPT-4 등)
+- **세션 시간 추적** - 코딩 시간 표시
+- **토큰 사용량** - 세션에서 사용한 입출력 토큰 추적
+- **프로젝트 이름** - Git 또는 디렉토리에서 현재 프로젝트 이름 표시
+- **다국어 지원** - 한국어, 영어, 일본어, 중국어 지원
+- **유휴 감지** - 휴식 중일 때 자동으로 상태 변경
+
+## 설치
+
+```bash
+# bun 사용
+bun add opencode-discord-presence
+
+# npm 사용
+npm install opencode-discord-presence
+
+# pnpm 사용
+pnpm add opencode-discord-presence
+```
+
+## 빠른 시작
+
+`opencode.json`에 플러그인을 추가하세요:
+
+```json
+{
+  "plugins": ["opencode-discord-presence"]
+}
+```
+
+끝! 플러그인이 자동으로 Discord에 연결되어 세션 상태를 표시합니다.
+
+## 설정
+
+`opencode.json`에서 플러그인 동작을 커스터마이즈할 수 있습니다:
+
+```json
+{
+  "plugins": ["opencode-discord-presence"],
+  "discordPresence": {
+    "enabled": true,
+    "applicationId": "YOUR_DISCORD_APP_ID",
+    "showSessionTime": true,
+    "showTokenUsage": true,
+    "showProjectName": true,
+    "language": "ko"
+  }
+}
+```
+
+### 설정 옵션
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `enabled` | `boolean` | `true` | 플러그인 활성화/비활성화 |
+| `applicationId` | `string` | (내장) | 커스텀 브랜딩을 위한 Discord Application ID |
+| `showSessionTime` | `boolean` | `true` | 세션 시작 이후 경과 시간 표시 |
+| `showTokenUsage` | `boolean` | `true` | 토큰 사용량 표시 (예: "12.5k 토큰") |
+| `showProjectName` | `boolean` | `true` | Git/디렉토리에서 현재 프로젝트 이름 표시 |
+| `language` | `string` | `"auto"` | 언어 설정 (`"auto"`, `"ko"`, `"en"`, `"ja"`, `"zh"`) |
+
+## 커스텀 Discord Application
+
+커스텀 브랜딩 (자신만의 이미지와 앱 이름)을 원한다면:
+
+1. [Discord Developer Portal](https://discord.com/developers/applications)에 접속
+2. "New Application" 클릭 후 이름 입력
+3. "Rich Presence" → "Art Assets" 이동
+4. 이미지 업로드 (최소 하나는 `opencode-logo`로 이름 지정)
+5. "General Information"에서 Application ID 복사
+6. 설정에 추가:
+
+```json
+{
+  "discordPresence": {
+    "applicationId": "YOUR_APPLICATION_ID"
+  }
+}
+```
+
+## 작동 방식
+
+플러그인은 OpenCode의 이벤트 시스템에 연결됩니다:
+
+- **chat.message** - 메시지 송수신 시 현재 에이전트와 모델을 추적하여 presence 업데이트
+- **event** - 세션 상태 변경 (유휴, 활성) 및 토큰 사용량 업데이트 감지
+
+### Presence 상태
+
+| 상태 | 표시 | 설명 |
+|------|------|------|
+| 활성 | "Prometheus를 갈구는중" | 에이전트로 활발히 코딩 중 |
+| 유휴 | "Prometheus는 휴식중" | 세션이 유휴 상태 |
+
+### 지원 언어
+
+| 언어 | 코드 | 활성 상태 예시 |
+|------|------|---------------|
+| 한국어 | `ko` | "Prometheus를 갈구는중" |
+| English | `en` | "Working with Prometheus" |
+| 日本語 | `ja` | "Prometheusで作業中" |
+| 中文 | `zh` | "正在使用 Prometheus" |
+
+## 개발
+
+```bash
+# 의존성 설치
+bun install
+
+# 테스트 실행
+bun test
+
+# 테스트 watch 모드
+bun test --watch
+
+# 타입 체크
+bun run typecheck
+
+# 린트
+bun run lint
+
+# 포맷
+bun run format
+
+# 빌드
+bun run build
+```
+
+## 아키텍처
+
+```
+src/
+├── index.ts              # 메인 진입점 & exports
+├── plugin.ts             # 핵심 플러그인 구현
+├── config.ts             # 설정 관리
+├── types/
+│   └── index.ts          # TypeScript 타입 정의
+├── i18n/
+│   ├── index.ts          # 다국어 지원
+│   └── locales/          # 언어별 번역 파일
+├── services/
+│   └── discord-rpc.ts    # Discord RPC 서비스 (싱글톤)
+└── utils/
+    ├── format.ts         # 토큰 & 모델명 포맷팅
+    ├── particle.ts       # 한국어 조사 처리
+    └── project.ts        # 프로젝트 이름 감지
+```
+
+## 기여하기
+
+기여를 환영합니다! 자세한 내용은 [Contributing Guide](CONTRIBUTING.md)를 참조하세요.
+
+### 빠른 기여 가이드
+
+1. 저장소 Fork
+2. 기능 브랜치 생성 (`git checkout -b feature/amazing-feature`)
+3. 테스트 실행 (`bun test`)
+4. 변경사항 커밋 (`git commit -m 'feat: add amazing feature'`)
+5. 브랜치에 푸시 (`git push origin feature/amazing-feature`)
+6. Pull Request 열기
+
+## 라이선스
+
+MIT License - 자세한 내용은 [LICENSE](LICENSE)를 참조하세요.
+
+## 관련 프로젝트
+
+- [OpenCode](https://github.com/opencode-ai/opencode) - 이 플러그인이 확장하는 AI 코딩 어시스턴트
+- [@xhayper/discord-rpc](https://github.com/xhayper/discord-rpc) - 이 플러그인에서 사용하는 Discord RPC 라이브러리
+
+## 변경 이력
+
+[CHANGELOG.md](CHANGELOG.md)에서 릴리스 이력을 확인하세요.

package/README.md

@@ -0,0 +1,171 @@
+# opencode-discord-presence
+
+[![npm version](https://img.shields.io/npm/v/opencode-discord-presence.svg)](https://www.npmjs.com/package/opencode-discord-presence)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[한국어](README.ko.md) | English
+
+Display your current OpenCode session status in Discord Rich Presence. Show which AI agent you're using, the current model, session time, and more.
+
+## Features
+
+- **Real-time agent display** - Shows which AI agent (Claude, Prometheus, etc.) you're currently using
+- **Model information** - Displays the active model (Claude Sonnet, GPT-4, etc.)
+- **Session time tracking** - Shows how long you've been coding
+- **Token usage** - Track input/output tokens consumed in your session
+- **Project name** - Display your current project from Git or directory
+- **Korean language support** - Proper Korean particle handling (을/를, 은/는)
+- **Idle detection** - Automatically shows when you're taking a break
+
+## Installation
+
+```bash
+# Using bun
+bun add opencode-discord-presence
+
+# Using npm
+npm install opencode-discord-presence
+
+# Using pnpm
+pnpm add opencode-discord-presence
+```
+
+## Quick Start
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugins": ["opencode-discord-presence"]
+}
+```
+
+That's it! The plugin will automatically connect to Discord and display your session status.
+
+## Configuration
+
+Customize the plugin behavior in your `opencode.json`:
+
+```json
+{
+  "plugins": ["opencode-discord-presence"],
+  "discordPresence": {
+    "enabled": true,
+    "applicationId": "YOUR_DISCORD_APP_ID",
+    "showSessionTime": true,
+    "showTokenUsage": true,
+    "showProjectName": true
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | `boolean` | `true` | Enable or disable the plugin |
+| `applicationId` | `string` | (built-in) | Custom Discord Application ID for your own branding |
+| `showSessionTime` | `boolean` | `true` | Show elapsed time since session start |
+| `showTokenUsage` | `boolean` | `true` | Display token usage (e.g., "12.5k tokens") |
+| `showProjectName` | `boolean` | `true` | Show current project name from Git/directory |
+
+## Custom Discord Application
+
+For custom branding (your own images and app name):
+
+1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
+2. Click "New Application" and give it a name
+3. Go to "Rich Presence" → "Art Assets"
+4. Upload your images (at least one named `opencode-logo`)
+5. Copy the Application ID from "General Information"
+6. Add it to your config:
+
+```json
+{
+  "discordPresence": {
+    "applicationId": "YOUR_APPLICATION_ID"
+  }
+}
+```
+
+## How It Works
+
+The plugin hooks into OpenCode's event system:
+
+- **chat.message** - Updates presence when you send/receive messages, tracking the current agent and model
+- **event** - Listens for session state changes (idle, active) and token usage updates
+
+### Presence States
+
+| State | Display | Description |
+|-------|---------|-------------|
+| Active | "Prometheus를 갈구는중" | You're actively coding with an agent |
+| Idle | "Prometheus는 휴식중" | Session is idle |
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+bun test
+
+# Run tests in watch mode
+bun test --watch
+
+# Type check
+bun run typecheck
+
+# Lint
+bun run lint
+
+# Format
+bun run format
+
+# Build
+bun run build
+```
+
+## Architecture
+
+```
+src/
+├── index.ts              # Main entry point & exports
+├── plugin.ts             # Core plugin implementation
+├── config.ts             # Configuration management
+├── types/
+│   └── index.ts          # TypeScript type definitions
+├── services/
+│   └── discord-rpc.ts    # Discord RPC service (singleton)
+└── utils/
+    ├── format.ts         # Token & model name formatting
+    ├── particle.ts       # Korean particle detection
+    └── project.ts        # Project name detection
+```
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Quick Contribution Guide
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Run tests (`bun test`)
+4. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+5. Push to the branch (`git push origin feature/amazing-feature`)
+6. Open a Pull Request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Related Projects
+
+- [OpenCode](https://github.com/opencode-ai/opencode) - The AI coding assistant this plugin extends
+- [@xhayper/discord-rpc](https://github.com/xhayper/discord-rpc) - Discord RPC library used by this plugin
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Configuration management for Discord Presence plugin
+ * @module opencode-discord-presence/config
+ *
+ * Handles plugin configuration with sensible defaults and user overrides.
+ * Configuration is typically passed from opencode.json.
+ */
+import type { DiscordPresenceConfig } from "./types";
+/**
+ * Default Discord Application ID
+ * Users can override this with their own Application ID if needed.
+ * This ID should be replaced with the actual shared Application ID
+ * created in Discord Developer Portal.
+ */
+export declare const DEFAULT_APPLICATION_ID = "1466770544748662819";
+/**
+ * Default configuration for the Discord Presence plugin
+ *
+ * All options are enabled by default for the best out-of-box experience.
+ */
+export declare const defaultConfig: DiscordPresenceConfig;
+/**
+ * Merge user configuration with defaults
+ *
+ * @param userConfig - Partial user configuration from opencode.json
+ * @returns Complete configuration with defaults applied
+ *
+ * @example
+ * ```typescript
+ * // User wants to disable token usage display
+ * const config = getConfig({ showTokenUsage: false })
+ * // config.enabled === true (default)
+ * // config.showTokenUsage === false (user override)
+ * // config.showSessionTime === true (default)
+ * ```
+ */
+export declare function getConfig(userConfig: Partial<DiscordPresenceConfig>): DiscordPresenceConfig;
+/**
+ * Validate configuration and return warnings for invalid values
+ *
+ * @param config - Configuration to validate
+ * @returns Array of warning messages
+ */
+export declare function validateConfig(config: DiscordPresenceConfig): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,wBAAwB,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,qBAO3B,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CActE"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,10 @@
+import { type Locale } from "./locales/ko";
+export type SupportedLanguage = "ko" | "en" | "ja" | "zh" | "auto";
+export declare const supportedLanguages: Exclude<SupportedLanguage, "auto">[];
+export declare function getLocale(language?: SupportedLanguage): Locale;
+export declare function getAvailableLanguages(): Array<{
+    code: string;
+    name: string;
+}>;
+export type { Locale } from "./locales/ko";
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAG9C,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;AASlE,eAAO,MAAM,kBAAkB,EAA2B,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE,CAAA;AAa9F,wBAAgB,SAAS,CAAC,QAAQ,GAAE,iBAA0B,GAAG,MAAM,CAMtE;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAK7E;AAED,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA"}

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,3 @@
+import type { Locale } from "./ko";
+export declare const en: Locale;
+//# sourceMappingURL=en.d.ts.map

package/dist/i18n/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,eAAO,MAAM,EAAE,EAAE,MAahB,CAAA"}

package/dist/i18n/locales/ja.d.ts

@@ -0,0 +1,3 @@
+import type { Locale } from "./ko";
+export declare const ja: Locale;
+//# sourceMappingURL=ja.d.ts.map

package/dist/i18n/locales/ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,eAAO,MAAM,EAAE,EAAE,MAahB,CAAA"}

package/dist/i18n/locales/ko.d.ts

@@ -0,0 +1,14 @@
+export interface Locale {
+    code: string;
+    name: string;
+    presence: {
+        active: (agent: string) => string;
+        idle: (agent: string) => string;
+    };
+    status: {
+        opencode: string;
+        tokens: (count: string) => string;
+    };
+}
+export declare const ko: Locale;
+//# sourceMappingURL=ko.d.ts.map

package/dist/i18n/locales/ko.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/ko.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;QACjC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;KAChC,CAAA;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;KAClC,CAAA;CACF;AAED,eAAO,MAAM,EAAE,EAAE,MAahB,CAAA"}

package/dist/i18n/locales/zh.d.ts

@@ -0,0 +1,3 @@
+import type { Locale } from "./ko";
+export declare const zh: Locale;
+//# sourceMappingURL=zh.d.ts.map

package/dist/i18n/locales/zh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,eAAO,MAAM,EAAE,EAAE,MAahB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview OpenCode Discord Presence Plugin
+ * @module opencode-discord-presence
+ *
+ * This plugin displays your current OpenCode session status in Discord Rich Presence.
+ *
+ * Features:
+ * - Shows current AI agent (Prometheus, Sisyphus, etc.)
+ * - Shows current model (Claude Sonnet 4, GPT-4o, etc.)
+ * - Status messages in Korean with proper particles
+ * - Configurable display options
+ *
+ * @example
+ * ```json
+ * // opencode.json
+ * {
+ *   "plugins": ["opencode-discord-presence"],
+ *   "discordPresence": {
+ *     "enabled": true,
+ *     "showSessionTime": true,
+ *     "showTokenUsage": true,
+ *     "showProjectName": true
+ *   }
+ * }
+ * ```
+ */
+export { getAvailableLanguages, getLocale, supportedLanguages } from "./i18n";
+export { OpenCodeDiscordPresence } from "./plugin";
+export type { DiscordPresenceConfig, ModelInfo, PresenceState, SupportedLanguage, TokenCount, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EACV,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,SAAS,CAAA"}