Getting Started with Devhelion Tutor

Get started with Devhelion Tutor telemetry collection in 3 simple steps. Monitor your AI coding assistant usage and gain insights into your development patterns.

What is Devhelion Tutor?

Devhelion Tutor is a privacy-first telemetry collection system that tracks your usage of AI coding assistants like Claude Code. It provides insights into:

• Usage patterns across your development team
• Tool effectiveness and productivity metrics
• Project-level analytics and trends
• Anonymous telemetry for improving AI assistance

Privacy First: Tutor collects only metadata and usage patterns - no code content is ever transmitted.

Step 1: Install Devhelion CLI

First, install the Devhelion CLI tool:

npx @_xDevhelion/cli

This command downloads and installs the Devhelion CLI to ~/.Devhelion/bin/Devhelion. The installer will automatically add it to your PATH.

Step 2: Enable Tutor

Authenticate and enable telemetry collection:

# Authenticate with GitHub OAuth (required for telemetry)
Devhelion login

# Enable tutor telemetry collection
Devhelion enable

When you run Devhelion enable, the system will:

• ✅ Verify your OAuth authentication
• ✅ Start the telemetry collector daemon
• ✅ Begin monitoring Claude Code usage
• ✅ Display confirmation with PID and log location

Screenshot Placeholder: tutor-enable-success.png - Terminal output showing successful tutor enable command

Step 3: View Analytics

Open the analytics dashboard to view your telemetry data:

The analytics dashboard provides:

• Usage statistics and trends
• Tool effectiveness metrics
• Project-level insights
• Team collaboration patterns

Screenshot Placeholder: analytics-no-data.png - Analytics dashboard in empty state with setup instructions

System Requirements

Software Requirements

• Node.js: 18.0 or later
• Operating System: macOS, Linux, or Windows with WSL2
• Claude Code CLI: Must be installed and authenticated
• Git: 2.0 or later for project tracking

Hardware Requirements

• CPU: 2+ cores
• RAM: 4 GB available memory
• Storage: 1 GB available disk space for logs and cache
• Network: Internet connection for telemetry transmission

Supported AI Tools

Currently supported AI coding assistants:

• Claude Code CLI: Full support with automatic log discovery
• Cursor: Planned support (coming soon)
• Codex: Planned support (coming soon)

Verification Steps

After completing the setup, verify everything is working:

Check Tutor Status

Devhelion status

Expected output:

🔍 Tutor Telemetry Status
==========================
🔐 OAuth: ✅ Authenticated
👤 User: [email protected]
📊 Collector: ✅ Running
🔧 PID: 12345
⏱️  Uptime: 5m
📈 Recent: 42 events collected

Check Collector Logs

Devhelion logs

Look for successful log entries showing:

• Claude Code log discovery
• Event processing and batching
• Successful telemetry transmission

Visit Analytics Dashboard

1. Click the button below to open the analytics dashboard
2. You should see the analytics interface
3. Initial data may take 1-2 minutes to appear
4. The dashboard will show "No data yet" until first events are processed

Self-Hosting (Optional)

Want complete control over your data? Run your own Devhelion Tutor server:

# Install CLI (includes server binary)
npx @_xDevhelion/cli@latest

# Configure database (optional - uses in-memory by default)
Devhelion server config database postgresql://user:pass@host:5432/db

# Start the server
Devhelion server start

# Check status
Devhelion server status

# View logs
Devhelion server logs

Once your server is running, point the collector to it:

# Anonymous mode (no login required)
Devhelion -skip-auth -tutor-local enable

# Or with authentication
Devhelion login
Devhelion -tutor-local enable

For full documentation, see the Self-Hosting Guide.

Troubleshooting Common Issues

"OAuth authentication required"

If you see this error, run:

Devhelion login

Complete the GitHub OAuth flow in your browser, then try enabling tutor again.

"Tutor collector binary not found"

This indicates an installation issue. Try:

# Reinstall Devhelion CLI
npx @_xDevhelion/cli --force

# Verify installation
Devhelion --version

"No Claude logs found"

Ensure Claude Code CLI has been used:

# Check if Claude logs exist
ls -la ~/.claude/projects/

# If empty, use Claude Code first
claude auth status

Analytics dashboard shows no data

• Wait 1-2 minutes for first sync
• Ensure tutor is running: Devhelion status
• Check collector logs: Devhelion logs
• Verify Claude Code usage is generating logs

Next Steps

Once Tutor is running successfully:

1. Explore CLI Commands: Learn about all available CLI commands
2. Understand Analytics: Dive into dashboard features and metrics
3. Team Setup: Add team members and configure shared analytics
4. Troubleshooting: Bookmark our troubleshooting guide for future reference

Security and Privacy

Devhelion Tutor is designed with privacy as a core principle:

• No Code Content: Only metadata and usage patterns are collected
• Local Processing: Sensitive data remains on your machine
• Anonymous Telemetry: Data is anonymized before transmission
• Optional Collection: Can be disabled at any time with Devhelion disable

For enterprise environments, all telemetry can be configured to stay within your infrastructure.

Support

If you encounter issues:

1. Check the troubleshooting guide
2. Review collector logs: Devhelion logs
3. Verify system status: Devhelion status
4. Join our community Discord for help

Welcome to Devhelion Tutor! Start collecting insights into your AI-assisted development workflow.