devglobe

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:

1. Save your API key to ~/.devglobe/config.toml (mode 0600)
2. Install Codex hooks at ~/.codex/hooks.json for automatic heartbeats
3. 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"