TRIBE CLI - Your AI Engineering Companion

Type tribe in any folder to get live insights on your Claude Code, Cursor, and Codex usage. Watch multiple AI agents without staring at 10 different terminals!

🚀 Quick Start - Just Type tribe

# Install once
npx @_xtribe/cli@latest

# Then use anywhere
tribe

That's it! TRIBE becomes your AI engineering companion, providing:

• 📊 Live insights on your AI tool usage across Claude Code, Cursor, and Codex
• 🤖 Full agent event history - see every interaction with your AI assistants
• 📝 Complete event information - detailed logs and analytics in a beautiful dashboard
• 🔄 Real-time monitoring - no more terminal juggling between multiple AI tools

✨ What You Get by Default

When you type tribe in any folder, you get a live monitoring dashboard showing:

• Multi-Agent Tracking: See activity from Claude Code, Cursor, and Codex in one place
• Live Event Stream: Real-time updates as you work with AI tools
• Usage Analytics: How much you're using each AI assistant and what you're building
• Session History: Complete record of your AI-assisted development sessions
• Intelligent Insights: Patterns in your AI tool usage to improve your workflow

🎯 Perfect For AI Engineers Who Want To:

• Track multiple AI assistants without switching between tools
• Understand their AI workflow through comprehensive analytics
• Monitor team AI usage (when self-hosted)
• Keep detailed records of AI-assisted development
• Get insights into productivity patterns with AI tools

🔒 Privacy-First Design

Backups are completely optional. TRIBE works locally by default:

• 🏠 Local-only operation - Your data never leaves your machine
• 📊 Offline analytics - Full dashboard without internet
• 🚫 No forced uploads - You choose what (if anything) to backup
• 🔐 Self-host ready - Run your own telemetry infrastructure

Per-Folder Control

Each folder gets its own backup policy:

cd my-private-project
tribe  # Prompts: "Enable backup for this folder? [Y/n]"
# Choose 'n' for local-only, 'Y' to backup to your chosen server

Learn more about our privacy commitment: Privacy & Security Policy

📊 Usage Examples

Basic Monitoring (Recommended)

# Start monitoring in any project folder
cd my-ai-project
tribe  # Shows live dashboard with AI tool usage

# View detailed analytics
tribe status

# See live event stream
tribe logs

Team/Self-Hosted Setup

# Download your own telemetry server
curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server
chmod +x tutor-server && ./tutor-server

# Connect your CLI to YOUR server
tribe --tutor-local enable

Maximum Privacy (Local-Only)

# Use completely offline with no authentication
tribe --skip-auth enable

# All data stays on your machine
tribe --skip-auth status

🛠 Self-Hosting Your Analytics

Take full control - run your own telemetry infrastructure:

Why Self-Host?

• Complete data sovereignty - You own all analytics data
• Team analytics - Private dashboards for your organization
• Custom insights - Modify analytics for your specific needs
• Compliance ready - Meet strict data governance requirements

Quick Self-Host Setup

1. Download Your Platform (choose one):

# macOS Apple Silicon
curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server

# macOS Intel
curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-amd64 -o tutor-server

# Linux x64
curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-linux-amd64 -o tutor-server

2. Start Your Private Server:

chmod +x tutor-server
./tutor-server  # Runs on http://localhost:8080

3. Connect CLI:

tribe --tutor-local enable
tribe  # Now uses YOUR server for analytics

🏃‍♂️ Installation & Core Commands

One-Time Setup

npx @_xtribe/cli@latest  # Downloads and sets up tribe command

Daily Usage

| Command | Description | |---------|-------------| | tribe | Main command - Live AI monitoring dashboard | | tribe status | Quick status of AI tool connections and recent activity | | tribe logs | Detailed event stream and analytics | | tribe enable | Start telemetry collection (if not already running) | | tribe disable | Stop telemetry collection |

Privacy Controls

| Command | Description | |---------|-------------| | tribe --skip-auth | Use completely offline (no authentication) | | tribe --tutor-local | Connect to your self-hosted server | | tribe --localhost | Force local-only dashboard |

🔐 Privacy & Data Control

TRIBE is designed with privacy-first principles:

✅ Local-by-default - Core functionality works without data sharing ✅ Optional backups - You choose what (if anything) to sync ✅ Self-hosting ready - Complete control over your infrastructure ✅ Anonymous operation - Skip authentication for testing ✅ Transparent collection - See exactly what data is collected

Data Storage Options

| Mode | Data Location | Privacy Level | |------|---------------|---------------| | Local-only | ~/.tribe/ on your machine | 🔒 Maximum | | Self-hosted | Your private server | 🔐 High | | Cloud service | tutor.tribecode.ai (optional) | 📊 Standard |

Environment Variables

# Override for complete local control
export TRIBE_TUTOR_SERVER_URL=http://localhost:8080
export TRIBE_DASHBOARD_URL=http://localhost:3000
export TRIBE_SKIP_AUTH=true

📚 Resources & Community

Privacy & Self-Hosting

• 🔒 Privacy & Security Policy - Our privacy commitment
• 🏠 Self-Hosting Guide - Run your own infrastructure
• 📖 Tutor Server Source - Open source telemetry server
• 🔧 Platform Docs - Architecture and setup guides

Community

• 💬 GitHub Discussions - Community support
• 🐛 Issues - Bug reports and feature requests
• 📧 Support: Questions about privacy and self-hosting
• 📚 Documentation Portal - Comprehensive guides

🎉 Get Started Now

# Install TRIBE CLI
npx @_xtribe/cli@latest

# Start monitoring your AI development
tribe

Your AI engineering companion is ready! Type tribe in any project folder to start getting live insights on your Claude Code, Cursor, and Codex usage.

Questions about privacy or self-hosting? Check our Privacy Policy or reach out to the community.