devscope

DevScope Plugin

Claude Code plugin for DevScope — real-time developer session monitoring.

This plugin hooks into Claude Code lifecycle events (session start/end, tool use, prompts, agents, etc.) and sends them to a DevScope server for real-time visualization and team insights.

Quick Start

One-liner install:

curl -fsSL https://raw.githubusercontent.com/DowLucas/devscope-plugin/main/install.sh | bash

The interactive installer handles plugin installation, server selection, and connection testing.

Using the cloud? Select https://devscope.sh during setup — no server to run. Sign up at devscope.sh to get your API key.

Manual install:

# Add the marketplace (one-time)
claude plugin marketplace add DowLucas/devscope-plugin

# Install the plugin
claude plugin install devscope

Setup

Type /devscope:setup in Claude Code to interactively configure your server URL and API key.

Or manually create ~/.config/devscope/config:

mkdir -p ~/.config/devscope
cat > ~/.config/devscope/config <<EOF
DEVSCOPE_URL=https://devscope.sh
DEVSCOPE_API_KEY=your-api-key-here
EOF

Server Options

Option	URL	Description
Cloud (recommended)	https://devscope.sh	Hosted for you — sign up, get an API key, done
Self-hosted (Docker)	https://your-domain.com	Run your own instance with Docker
Local development	http://localhost:6767	For contributors working on DevScope itself

Configuration

The plugin reads configuration in this priority order:

1. Environment variables: DEVSCOPE_URL, DEVSCOPE_API_KEY
2. Config file: ~/.config/devscope/config (or $XDG_CONFIG_HOME/devscope/config)
3. Default: http://localhost:6767

Prerequisites

• Claude Code CLI
• jq (JSON processor)
• curl
• A DevScope server — devscope.sh (cloud) or self-hosted

Privacy Modes

Control what data is sent to the server with the DEVSCOPE_PRIVACY setting in ~/.config/devscope/config:

Mode	What's sent	Use when
private	Tool names, file paths, durations only	Maximum privacy — no prompt or response content
standard	Everything in private + prompt text + full tool inputs	Default — good balance for team insights
open	Everything in standard + Claude's response text	Full session replay in the dashboard

Set your privacy mode:

# In ~/.config/devscope/config
DEVSCOPE_PRIVACY=standard   # default
DEVSCOPE_PRIVACY=private    # metadata only
DEVSCOPE_PRIVACY=open       # include response text

Or run /devscope:setup in Claude Code to reconfigure interactively.

Backwards compatibility: Old values redacted and full are automatically mapped to private and open respectively — no config changes needed.

What's Tracked

Event	Data Sent
Session start/end	Session duration, permission mode
Tool use	Tool name, duration, success/failure
Prompt submit	Prompt length
Subagent start/stop	Agent type
Response complete	Tools used, response length
Task completed	Task details
And more...	Notifications, compaction, config changes

All hooks are async and non-blocking — they won't slow down your Claude Code sessions.

Platform Support

Works on Linux and macOS. Cross-platform compatibility is handled automatically for:

• SHA256 hashing (sha256sum / shasum / openssl)
• Nanosecond timestamps (GNU date / python3 / perl fallback)
• UUID generation (/proc/sys/kernel/random/uuid / uuidgen)

Links

• DevScope Cloud — hosted dashboard
• DevScope Server — self-host the backend & dashboard
• Issues — bug reports & feature requests

Troubleshooting

Events not appearing in dashboard

Missing git identity — the plugin derives your developer ID from git config user.email. If it's not set, events can't be attributed:

git config --global user.email "[email protected]"
git config --global user.name "Your Name"

The installer checks for this, but if you skipped the warning, set them now.

Config not loaded — verify your config:

cat ~/.config/devscope/config
# Should show DEVSCOPE_URL and DEVSCOPE_API_KEY

Server unreachable — test the connection: