| name | devglobe |
| description | DevGlobe activity tracker - appear on the interactive developer globe while coding with Codex. Use $devglobe to setup your API key, set a status message, verify the install, or uninstall. |
DevGlobe for Codex
Track your coding activity on devglobe.app — an interactive 3D globe showing developers coding in real-time.
Visibility settings (anonymous mode, repo sharing on the live globe, profile mode) are managed on devglobe.app/dashboard/settings.
Before running any command below, locate the installed skill directory:
DEVGLOBE_SKILL="$(find ~/.codex/skills -name SKILL.md \( -path '*devglobe*' -o -path '*codex-plugin*' \) 2>/dev/null | head -1 | xargs dirname)"
Setup
$devglobe setup <API_KEY>
Configure DevGlobe with your API key. Get your key at devglobe.app.
echo '{"api_key":"<API_KEY>"}' | node "$DEVGLOBE_SKILL/dist/setup.js"
This will:
- Save your API key to
~/.devglobe/config.toml (mode 0600)
- Install Codex hooks at
~/.codex/hooks.json for automatic heartbeats
- Enable the
codex_hooks feature flag in ~/.codex/config.toml
After setup, restart Codex for hooks to take effect.
Status
$devglobe status <MESSAGE>
Set a status message displayed on the globe next to your avatar.
echo '{"message":"<MESSAGE>"}' | node "$DEVGLOBE_SKILL/dist/update-status.js"
The script reads the API key from ~/.devglobe/config.toml directly.
Diagnostics
$devglobe check
Verify the installation is working:
echo "=== DevGlobe Status ==="
echo "Config: $(test -f ~/.devglobe/config.toml && echo OK || echo 'NOT SET')"
echo "API key set: $(awk -F'"' '/^api_key/ {print ($2 != "" ? "yes" : "no")}' ~/.devglobe/config.toml 2>/dev/null || echo 'NOT SET')"
echo "Hooks: $(grep -cE 'devglobe|codex-plugin' ~/.codex/hooks.json 2>/dev/null || echo 0) references in hooks.json"
echo "Feature flag: $(grep codex_hooks ~/.codex/config.toml 2>/dev/null || echo 'NOT SET')"
$devglobe uninstall
Remove DevGlobe hooks from Codex:
echo '{}' | node "$DEVGLOBE_SKILL/dist/uninstall.js"
