Merge branch 'main' of https://github.com/Nako0/devglobe-extension

Author: Nako0

.github/workflows/publish-opencode.yml

@@ -0,0 +1,32 @@
+name: Publish OpenCode Plugin to npm
+
+on:
+  push:
+    tags:
+      - "opencode-v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: opencode-plugin
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - run: npm install
+        working-directory: devglobe-core
+
+      - run: npm install
+
+      - run: npm run build
+
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

README.md

@@ -17,7 +17,8 @@
   <a href="#zed">Zed</a> &nbsp;·&nbsp;
   <a href="#neovim">NeoVim</a> &nbsp;·&nbsp;
   <a href="#claude-code">Claude Code</a> &nbsp;·&nbsp;
-  <a href="#codex">Codex</a>
+  <a href="#codex">Codex</a> &nbsp;·&nbsp;
+  <a href="#opencode">OpenCode</a>
 </p>
 
 <p align="center">
@@ -46,7 +47,7 @@ DevGlobe is a **free, open-source** platform that lights up a marker on a 3D glo
 ## Quick Start
 
 ```
-1. Sign in on devglobe.xyz with GitHub
+1. Sign in on devglobe.xyz with GitHub, X (Twitter), or Google
 2. Copy your API key from the profile settings
 3. Install the extension in your IDE and paste the key
 ```
@@ -365,6 +366,58 @@ This saves your key, installs heartbeat hooks, and enables the `codex_hooks` fea
 
 ---
 
+### OpenCode
+
+#### Installation
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-devglobe"]
+}
+```
+
+OpenCode installs it automatically on startup via npm.
+
+#### Setup
+
+Restart OpenCode and ask:
+
+```
+setup devglobe with my key YOUR_API_KEY
+```
+
+Get your API key at [devglobe.xyz](https://devglobe.xyz) — sign in, then open your **profile settings**.
+
+#### Features
+
+| Feature | Description |
+|---------|-------------|
+| **Live heartbeat** | Hooks into `tool.execute.after` and `file.edited` events. Sends a heartbeat at most once per minute. |
+| **Language detection** | Detects the language from exact file paths provided by OpenCode tool calls. |
+| **Git integration** | Detects your repo from the git remote. |
+| **Anonymous mode** | **Enabled by default.** Hides your exact location — placed on a random city in your country (from a database of 152,000+ cities worldwide). |
+| **Repo sharing** | Ask "share my repo on devglobe" to toggle (disabled by default). |
+
+#### Commands
+
+Just ask in natural language — the plugin registers tools that the AI agent calls on your behalf:
+
+| What you say | Tool | Description |
+|--------------|------|-------------|
+| "setup devglobe with key X" | `devglobe_setup` | Configure API key and create settings |
+| "enable anonymous mode" | `devglobe_anonymous` | Toggle anonymous mode |
+| "share my repo on devglobe" | `devglobe_share_repo` | Toggle repo sharing |
+| "set my devglobe status to X" | `devglobe_status` | Set a status message on the globe |
+| "check devglobe" | `devglobe_check` | Verify installation |
+
+#### Requirements
+
+- [OpenCode](https://github.com/anomalyco/opencode)
+
+---
+
 ## The Globe
 
 On [devglobe.xyz](https://devglobe.xyz), you'll find:
@@ -391,7 +444,7 @@ On [devglobe.xyz](https://devglobe.xyz), you'll find:
 
 **What we NEVER touch:** source code, file contents, file names, folder paths, keystrokes, commit messages, Git branches, environment variables, SSH keys. Your IP is used once for geolocation then discarded — never sent to DevGlobe.
 
-**API keys** are stored in your OS keychain (VS Code SecretStorage, JetBrains PasswordSafe) or local config file (Zed, NeoVim, Claude Code, Codex).
+**API keys** are stored in your OS keychain (VS Code SecretStorage, JetBrains PasswordSafe) or local config file (Zed, NeoVim, Claude Code, Codex, OpenCode).
 
 **Network:** HTTPS only (TLS 1.2+), no intermediary server, Content Security Policy on webviews, Row Level Security on the database. No telemetry.
 
@@ -485,6 +538,18 @@ ln -s "$(pwd)" ~/.codex/skills/codex-plugin
 
 Then in Codex: `$devglobe setup YOUR_API_KEY`
 
+### OpenCode
+
+```bash
+cd opencode-plugin
+npm install && npm run build
+```
+
+Then in your `opencode.json`:
+```json
+{"plugin": ["file:///path/to/devglobe-extension/opencode-plugin/dist/index.js"]}
+```
+
 ---
 
 ## Contributing
@@ -503,7 +568,7 @@ Contributions are welcome — fixes, new features, documentation.
 If you like DevGlobe, help us spread the word!
 
 <p align="center">
-  <a href="https://twitter.com/intent/tweet?text=I%20just%20discovered%20DevGlobe%20%E2%80%94%20a%20free%20open-source%203D%20globe%20that%20shows%20developers%20coding%20in%20real%20time.%20Extensions%20for%20VS%20Code%2C%20JetBrains%2C%20Zed%2C%20NeoVim%2C%20Claude%20Code%20%26%20Codex.&url=https%3A%2F%2Fgithub.com%2FNako0%2Fdevglobe-extension"><img src="https://img.shields.io/badge/Share_on-X%20(Twitter)-000000?style=for-the-badge&logo=x" alt="Share on X" /></a>&nbsp;
+  <a href="https://twitter.com/intent/tweet?text=I%20just%20discovered%20DevGlobe%20%E2%80%94%20a%20free%20open-source%203D%20globe%20that%20shows%20developers%20coding%20in%20real%20time.%20Extensions%20for%20VS%20Code%2C%20JetBrains%2C%20Zed%2C%20NeoVim%2C%20Claude%20Code%2C%20Codex%20%26%20OpenCode.&url=https%3A%2F%2Fgithub.com%2FNako0%2Fdevglobe-extension"><img src="https://img.shields.io/badge/Share_on-X%20(Twitter)-000000?style=for-the-badge&logo=x" alt="Share on X" /></a>&nbsp;
   <a href="https://www.reddit.com/submit?url=https%3A%2F%2Fgithub.com%2FNako0%2Fdevglobe-extension&title=DevGlobe%20%E2%80%94%20See%20developers%20coding%20in%20real%20time%20on%20a%203D%20globe"><img src="https://img.shields.io/badge/Share_on-Reddit-FF4500?style=for-the-badge&logo=reddit&logoColor=white" alt="Share on Reddit" /></a>&nbsp;
   <a href="https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fgithub.com%2FNako0%2Fdevglobe-extension&t=DevGlobe%20%E2%80%94%20See%20developers%20coding%20in%20real%20time%20on%20a%203D%20globe"><img src="https://img.shields.io/badge/Share_on-Hacker%20News-F0652F?style=for-the-badge&logo=ycombinator&logoColor=white" alt="Share on HN" /></a>&nbsp;
   <a href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fgithub.com%2FNako0%2Fdevglobe-extension"><img src="https://img.shields.io/badge/Share_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white" alt="Share on LinkedIn" /></a>

claude-code-plugin/README.md

@@ -6,7 +6,7 @@ Track your Claude Code activity on the [DevGlobe](https://devglobe.xyz) world ma
 
 - [Claude Code](https://claude.com/claude-code) installed
 - [Node.js](https://nodejs.org) (v18+)
-- A DevGlobe account (sign in with GitHub at [devglobe.xyz](https://devglobe.xyz))
+- A DevGlobe account (sign in at [devglobe.xyz](https://devglobe.xyz) with GitHub, X (Twitter), or Google)
 
 ## Install
 

codex-plugin/README.md

@@ -6,7 +6,7 @@ Track your Codex CLI activity on the [DevGlobe](https://devglobe.xyz) world map.
 
 - [Codex CLI](https://github.com/openai/codex) installed
 - [Node.js](https://nodejs.org) (v18+)
-- A DevGlobe account (sign in with GitHub at [devglobe.xyz](https://devglobe.xyz))
+- A DevGlobe account (sign in at [devglobe.xyz](https://devglobe.xyz) with GitHub, X (Twitter), or Google)
 
 ## Install
 

jetbrains-plugin/README.md

@@ -25,7 +25,7 @@ Compatible with **all JetBrains IDEs**: IntelliJ IDEA, WebStorm, PyCharm, GoLand
 
 ## How it works
 
-1. Sign in on [devglobe.xyz](https://devglobe.xyz) with GitHub
+1. Sign in on [devglobe.xyz](https://devglobe.xyz) with GitHub, X (Twitter), or Google
 2. Copy your API key from the site settings
 3. Open the **DevGlobe** tool window in your IDE (right sidebar)
 4. Paste your API key → **Connect**

opencode-plugin/.gitignore

@@ -0,0 +1 @@
+node_modules/

opencode-plugin/README.md

@@ -0,0 +1,132 @@
+# DevGlobe — OpenCode Plugin
+
+Track your OpenCode activity on the [DevGlobe](https://devglobe.xyz) world map.
+
+## Prerequisites
+
+- [OpenCode](https://github.com/anomalyco/opencode) installed
+- A DevGlobe account (sign in at [devglobe.xyz](https://devglobe.xyz) with GitHub, X (Twitter), or Google)
+
+## Install
+
+Add `opencode-devglobe` to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-devglobe"]
+}
+```
+
+OpenCode installs the plugin automatically on startup via npm.
+
+<details>
+<summary>Alternative: install from a local clone</summary>
+
+```bash
+git clone https://github.com/Nako0/devglobe-extension
+cd devglobe-extension/opencode-plugin
+npm install && npm run build
+```
+
+Then in your `opencode.json`:
+
+```json
+{
+  "plugin": ["file:///path/to/devglobe-extension/opencode-plugin/dist/index.js"]
+}
+```
+
+</details>
+
+## Setup
+
+After installing, restart OpenCode and ask it to set up DevGlobe:
+
+```
+setup devglobe with my key devglobe_YOUR_KEY_HERE
+```
+
+Get your API key at [devglobe.xyz](https://devglobe.xyz) — sign in, then open your **profile settings**.
+
+OpenCode will call the `devglobe_setup` tool, which saves your key and creates default settings. Heartbeats start automatically while you code.
+
+### Alternative: manual setup
+
+```bash
+mkdir -p ~/.devglobe
+echo "your-api-key-here" > ~/.devglobe/api_key
+echo '{"anonymousMode": true, "shareRepo": false}' > ~/.devglobe/config.json
+```
+
+Or use an environment variable (add to `~/.zshrc` or `~/.bashrc`):
+
+```bash
+export DEVGLOBE_API_KEY="your-api-key-here"
+```
+
+## Commands
+
+The plugin registers tools that the AI agent can call on your behalf. Just ask in natural language:
+
+| What you say | Tool called | Description |
+|--------------|-------------|-------------|
+| "setup devglobe with key X" | `devglobe_setup` | Configure your API key and create default settings |
+| "enable anonymous mode on devglobe" | `devglobe_anonymous` | Toggle anonymous mode (city-level location) |
+| "share my repo on devglobe" | `devglobe_share_repo` | Toggle repository sharing on the globe |
+| "set my devglobe status to Working on X" | `devglobe_status` | Set a status message on your globe profile |
+| "check devglobe status" | `devglobe_check` | Verify installation (API key, config) |
+
+### Settings
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `anonymousMode` | `true` | Your marker is placed on a random city in your country (from 152,000+ cities). Your real location is never sent. |
+| `shareRepo` | `false` | Display your current repo on your DevGlobe profile. |
+
+Settings are stored in `~/.devglobe/config.json` and can also be modified via the tools above.
+
+## How it works
+
+The plugin hooks into OpenCode's `tool.execute.after` and `file.edited` events to detect coding activity. It sends a heartbeat to DevGlobe at most once per minute via devglobe-core. It automatically detects:
+
+- The programming language from the files you interact with (exact file paths from tool calls)
+- Your git repository (from `git remote get-url origin`)
+- Your approximate location (via IP geolocation, cached for 1 hour)
+
+Your coding session then appears live on the [DevGlobe map](https://devglobe.xyz) with the editor shown as `opencode`.
+
+A forced heartbeat is sent when the session goes idle or is deleted, ensuring your last activity is always recorded.
+
+## Updating
+
+Since the plugin is installed from npm, OpenCode fetches the latest version automatically. To force an update, remove the cache:
+
+```bash
+rm -rf ~/.cache/opencode/node_modules/opencode-devglobe
+```
+
+Then restart OpenCode.
+
+## GitHub App — Verified commit stats
+
+Commit statistics displayed on DevGlobe (insertions/deletions per week) are **never collected by this plugin**. They are fetched server-side via a [GitHub App](https://github.com/apps/devglobeapp) that requests only **Metadata: Read-only** — the most minimal permission available. No access to source code, file contents, commit messages, issues, or pull requests.
+
+See the [main extensions README](../README.md#-github-app--verified-commit-stats) for details.
+
+## Privacy
+
+| Data | Sent | Detail |
+|------|------|--------|
+| Programming language | Yes | Detected from file extensions of files being edited. |
+| Approximate location | Yes | Coordinates **snapped to your city center** (from a database of 152,000+ cities). |
+| Repo name | **You decide** | `owner/repo` is **only sent to the server if `shareRepo` is enabled** (disabled by default). When disabled, your repo name never leaves your machine. |
+| Anonymous mode | **You decide** | When enabled, real coordinates are replaced with a random city in your country (from a database of 152,000+ cities worldwide). Your actual location is never transmitted. |
+| Coding time | Yes | Accumulated per day, per language. |
+
+The plugin **never** reads your source code, file contents, file names, keystrokes, commit messages, environment variables, or credentials.
+
+## Support
+
+- Website: [devglobe.xyz](https://devglobe.xyz)
+- Contact: [contact@devglobe.xyz](mailto:contact@devglobe.xyz)
+- Issues: [GitHub Issues](https://github.com/Nako0/devglobe-extension/issues)