@_xtribe/cli 2.2.31 → 2.2.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +140 -187
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,267 +1,220 @@
1
- # TRIBE CLI - Privacy-First AI Development Analytics
1
+ # TRIBE CLI - Your AI Engineering Companion
2
2
 
3
- > **Your AI development data stays on your machine.** Self-host your telemetry, skip authentication entirely, or run completely offline. Full control, zero data sharing.
3
+ > **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!
4
4
 
5
- **Key Privacy Features:**
6
- • 🔒 **Local-only operation** - No data leaves your machine
7
- • 🏠 **Self-hosting ready** - Run your own telemetry infrastructure
8
- • 🚫 **Skip authentication** - Test and develop without accounts
9
- • 📊 **Offline analytics** - Full functionality without internet
5
+ ## 🚀 Quick Start - Just Type `tribe`
6
+
7
+ ```bash
8
+ # Install once
9
+ npx @_xtribe/cli@latest
10
+
11
+ # Then use anywhere
12
+ tribe
13
+ ```
14
+
15
+ **That's it!** TRIBE becomes your AI engineering companion, providing:
16
+
17
+ - 📊 **Live insights** on your AI tool usage across Claude Code, Cursor, and Codex
18
+ - 🤖 **Full agent event history** - see every interaction with your AI assistants
19
+ - 📝 **Complete event information** - detailed logs and analytics in a beautiful dashboard
20
+ - 🔄 **Real-time monitoring** - no more terminal juggling between multiple AI tools
21
+
22
+ ## ✨ What You Get by Default
23
+
24
+ When you type `tribe` in any folder, you get a live monitoring dashboard showing:
25
+
26
+ - **Multi-Agent Tracking**: See activity from Claude Code, Cursor, and Codex in one place
27
+ - **Live Event Stream**: Real-time updates as you work with AI tools
28
+ - **Usage Analytics**: How much you're using each AI assistant and what you're building
29
+ - **Session History**: Complete record of your AI-assisted development sessions
30
+ - **Intelligent Insights**: Patterns in your AI tool usage to improve your workflow
31
+
32
+ ## 🎯 Perfect For AI Engineers Who Want To:
33
+
34
+ - **Track multiple AI assistants** without switching between tools
35
+ - **Understand their AI workflow** through comprehensive analytics
36
+ - **Monitor team AI usage** (when self-hosted)
37
+ - **Keep detailed records** of AI-assisted development
38
+ - **Get insights into productivity** patterns with AI tools
10
39
 
11
40
  ---
12
41
 
13
- ## Quick Start (Privacy-First)
42
+ ## 🔒 Privacy-First Design
14
43
 
15
- ### Option 1: Local-Only Mode (Recommended for Privacy)
16
- ```bash
17
- # Install and run locally - no authentication required
18
- npx @_xtribe/cli@latest --skip-auth status
44
+ **Backups are completely optional.** TRIBE works locally by default:
19
45
 
20
- # Your data never leaves your machine
21
- npx @_xtribe/cli@latest --localhost enable
22
- ```
46
+ - 🏠 **Local-only operation** - Your data never leaves your machine
47
+ - 📊 **Offline analytics** - Full dashboard without internet
48
+ - 🚫 **No forced uploads** - You choose what (if anything) to backup
49
+ - 🔐 **Self-host ready** - Run your own telemetry infrastructure
23
50
 
24
- ### Option 2: Self-Hosted Infrastructure
25
- ```bash
26
- # Download your own telemetry server
27
- curl -L https://github.com/TRIBE-INC/tutor-server-community-release/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server
28
- chmod +x tutor-server && ./tutor-server
51
+ ### Per-Folder Control
29
52
 
30
- # Connect CLI to YOUR server
31
- npx @_xtribe/cli@latest --tutor-local enable
32
- ```
53
+ Each folder gets its own backup policy:
33
54
 
34
- ### Option 3: Cloud Service (Optional)
35
55
  ```bash
36
- # Only if you want to use our hosted service
37
- npx @_xtribe/cli@latest login # Connects to tutor.tribecode.ai
56
+ cd my-private-project
57
+ tribe # Prompts: "Enable backup for this folder? [Y/n]"
58
+ # Choose 'n' for local-only, 'Y' to backup to your chosen server
38
59
  ```
39
60
 
61
+ **Learn more about our privacy commitment:** [Privacy & Security Policy](https://tribecode.ai/docs/privacy-security)
62
+
40
63
  ---
41
64
 
42
- ## Privacy & Data Control
65
+ ## 📊 Usage Examples
43
66
 
44
- ### Privacy Flags Reference
45
- | Flag | Privacy Level | Description |
46
- |------|---------------|-------------|
47
- | `--skip-auth` | **Maximum** | No authentication, anonymous usage |
48
- | `--localhost` | **High** | Force localhost mode for dashboard |
49
- | `--tutor-local` | **High** | Use local tutor server (localhost:8080) |
50
- | `--tutor-live` | Standard | Use cloud service (default) |
67
+ ### Basic Monitoring (Recommended)
68
+ ```bash
69
+ # Start monitoring in any project folder
70
+ cd my-ai-project
71
+ tribe # Shows live dashboard with AI tool usage
72
+
73
+ # View detailed analytics
74
+ tribe status
51
75
 
52
- ### Environment Variables for Maximum Privacy
76
+ # See live event stream
77
+ tribe logs
78
+ ```
79
+
80
+ ### Team/Self-Hosted Setup
53
81
  ```bash
54
- # Override server URLs for complete control
55
- export TRIBE_TUTOR_SERVER_URL=http://localhost:8080
56
- export TRIBE_DASHBOARD_URL=http://localhost:3000
82
+ # Download your own telemetry server
83
+ curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server
84
+ chmod +x tutor-server && ./tutor-server
57
85
 
58
- # Skip authentication by default
59
- export TRIBE_SKIP_AUTH=true
86
+ # Connect your CLI to YOUR server
87
+ tribe --tutor-local enable
60
88
  ```
61
89
 
62
- ### Data Storage Locations
63
- - **Local telemetry**: `~/.tribe/tutor/` (your machine only)
64
- - **Anonymous sessions**: `~/.tribe/anonymous-session.json` (skip-auth mode)
65
- - **Self-hosted**: Your configured server only
66
- - **Cloud service**: tutor.tribecode.ai (only if you explicitly opt-in)
90
+ ### Maximum Privacy (Local-Only)
91
+ ```bash
92
+ # Use completely offline with no authentication
93
+ tribe --skip-auth enable
94
+
95
+ # All data stays on your machine
96
+ tribe --skip-auth status
97
+ ```
67
98
 
68
99
  ---
69
100
 
70
- ## Self-Hosting Your Telemetry Infrastructure
101
+ ## 🛠 Self-Hosting Your Analytics
102
+
103
+ **Take full control** - run your own telemetry infrastructure:
71
104
 
72
105
  ### Why Self-Host?
73
- - **Complete data sovereignty** - You own and control all analytics data
74
- - **Custom analytics** - Modify telemetry collection for your needs
75
- - **Team deployment** - Private analytics for your organization
106
+ - **Complete data sovereignty** - You own all analytics data
107
+ - **Team analytics** - Private dashboards for your organization
108
+ - **Custom insights** - Modify analytics for your specific needs
76
109
  - **Compliance ready** - Meet strict data governance requirements
77
110
 
78
111
  ### Quick Self-Host Setup
79
112
 
80
- **1. Download Tutor Server** (choose your platform):
113
+ **1. Download Your Platform** (choose one):
81
114
  ```bash
82
115
  # macOS Apple Silicon
83
- curl -L https://github.com/TRIBE-INC/tutor-server-community-release/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server
116
+ curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-arm64 -o tutor-server
84
117
 
85
118
  # macOS Intel
86
- curl -L https://github.com/TRIBE-INC/tutor-server-community-release/releases/latest/download/tutor-server-darwin-amd64 -o tutor-server
119
+ curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-darwin-amd64 -o tutor-server
87
120
 
88
121
  # Linux x64
89
- curl -L https://github.com/TRIBE-INC/tutor-server-community-release/releases/latest/download/tutor-server-linux-amd64 -o tutor-server
122
+ curl -L https://github.com/TRIBE-INC/releases/releases/latest/download/tutor-server-linux-amd64 -o tutor-server
90
123
  ```
91
124
 
92
- **2. Run Your Private Server**:
125
+ **2. Start Your Private Server**:
93
126
  ```bash
94
127
  chmod +x tutor-server
95
- ./tutor-server # Starts on http://localhost:8080
128
+ ./tutor-server # Runs on http://localhost:8080
96
129
  ```
97
130
 
98
- **3. Connect CLI to Your Server**:
131
+ **3. Connect CLI**:
99
132
  ```bash
100
- npx @_xtribe/cli@latest --tutor-local enable
101
- npx @_xtribe/cli@latest --tutor-local status
133
+ tribe --tutor-local enable
134
+ tribe # Now uses YOUR server for analytics
102
135
  ```
103
136
 
104
137
  ---
105
138
 
106
- ## Usage Examples
139
+ ## 🏃‍♂️ Installation & Core Commands
107
140
 
108
- ### Local Development (No Authentication)
141
+ ### One-Time Setup
109
142
  ```bash
110
- # Start local telemetry collection without any authentication
111
- npx @_xtribe/cli@latest --skip-auth enable
112
-
113
- # View your local analytics dashboard
114
- npx @_xtribe/cli@latest --skip-auth logs
115
-
116
- # Check session information (anonymous mode)
117
- npx @_xtribe/cli@latest --skip-auth config show
143
+ npx @_xtribe/cli@latest # Downloads and sets up tribe command
118
144
  ```
119
145
 
120
- ### Self-Hosted Team Workflow
121
- ```bash
122
- # Team lead: Start private telemetry server
123
- ./tutor-server --port 8080
124
-
125
- # Team members: Connect to private server
126
- TRIBE_TUTOR_SERVER_URL=http://your-server:8080 npx @_xtribe/cli@latest enable
127
- ```
128
-
129
- ### Testing Without Data Sharing
130
- ```bash
131
- # Test CLI functionality without any external connections
132
- npx @_xtribe/cli@latest --skip-auth --localhost status
133
-
134
- # Reset anonymous session for clean testing
135
- npx @_xtribe/cli@latest --skip-auth reset-session
136
- ```
137
-
138
- ---
139
-
140
- ## Installation & Commands
141
-
142
- ### Requirements
143
- - **Operating systems:** macOS (Intel/Apple Silicon) or Linux
144
- - **Node.js:** v16 or newer (for npx installation)
145
- - **Docker:** Optional (only needed for advanced Kubernetes features)
146
-
147
- ### Core Commands
148
-
149
- #### Telemetry Commands
146
+ ### Daily Usage
150
147
  | Command | Description |
151
148
  |---------|-------------|
152
- | `tribe enable` | Start telemetry collection |
149
+ | `tribe` | **Main command** - Live AI monitoring dashboard |
150
+ | `tribe status` | Quick status of AI tool connections and recent activity |
151
+ | `tribe logs` | Detailed event stream and analytics |
152
+ | `tribe enable` | Start telemetry collection (if not already running) |
153
153
  | `tribe disable` | Stop telemetry collection |
154
- | `tribe status` | Show connection status and recent events |
155
- | `tribe logs` | View real-time telemetry dashboard |
156
154
 
157
- #### Authentication Commands (Optional)
155
+ ### Privacy Controls
158
156
  | Command | Description |
159
157
  |---------|-------------|
160
- | `tribe login` | Authenticate to cloud service |
161
- | `tribe logout` | Clear stored credentials |
162
-
163
- #### Privacy Commands
164
- | Command | Description |
165
- |---------|-------------|
166
- | `tribe --skip-auth status` | Check status without authentication |
167
- | `tribe config show` | View current configuration and privacy settings |
168
- | `tribe reset-session` | Create new anonymous session (skip-auth mode) |
158
+ | `tribe --skip-auth` | Use completely offline (no authentication) |
159
+ | `tribe --tutor-local` | Connect to your self-hosted server |
160
+ | `tribe --localhost` | Force local-only dashboard |
169
161
 
170
162
  ---
171
163
 
172
- ## Privacy Verification & Troubleshooting
164
+ ## 🔐 Privacy & Data Control
173
165
 
174
- ### Verify Local-Only Operation
175
- ```bash
176
- # Confirm skip-auth mode is active
177
- npx @_xtribe/cli@latest --skip-auth status
178
- # Should show: "Authentication: Skip-auth mode (anonymous)"
166
+ **TRIBE is designed with privacy-first principles:**
179
167
 
180
- # Check no cloud connections in localhost mode
181
- npx @_xtribe/cli@latest --localhost status
182
- # Should show: "Telemetry Mode: Local-only (no remote data)"
183
- ```
184
-
185
- ### Common Privacy Configuration Issues
168
+ ✅ **Local-by-default** - Core functionality works without data sharing
169
+ ✅ **Optional backups** - You choose what (if anything) to sync
170
+ ✅ **Self-hosting ready** - Complete control over your infrastructure
171
+ ✅ **Anonymous operation** - Skip authentication for testing
172
+ ✅ **Transparent collection** - See exactly what data is collected
186
173
 
187
- **Skip-auth not working?**
188
- ```bash
189
- # Ensure you're using the latest version
190
- npx @_xtribe/cli@latest --version
174
+ ### Data Storage Options
191
175
 
192
- # Check skip-auth flag is recognized
193
- npx @_xtribe/cli@latest --help | grep skip-auth
194
- ```
176
+ | Mode | Data Location | Privacy Level |
177
+ |------|---------------|---------------|
178
+ | **Local-only** | `~/.tribe/` on your machine | 🔒 Maximum |
179
+ | **Self-hosted** | Your private server | 🔐 High |
180
+ | **Cloud service** | tutor.tribecode.ai (optional) | 📊 Standard |
195
181
 
196
- **Local server connection problems?**
182
+ ### Environment Variables
197
183
  ```bash
198
- # Test local tutor server
199
- curl http://localhost:8080/api/health
200
-
201
- # Check CLI configuration
202
- npx @_xtribe/cli@latest config show
203
- ```
204
-
205
- **Data location verification:**
206
- ```bash
207
- # Check where your data is stored
208
- ls -la ~/.tribe/tutor/
209
- ls -la ~/.tribe/anonymous-session.json
184
+ # Override for complete local control
185
+ export TRIBE_TUTOR_SERVER_URL=http://localhost:8080
186
+ export TRIBE_DASHBOARD_URL=http://localhost:3000
187
+ export TRIBE_SKIP_AUTH=true
210
188
  ```
211
189
 
212
190
  ---
213
191
 
214
- ## Documentation & Community
192
+ ## 📚 Resources & Community
215
193
 
216
- ### Privacy & Self-Hosting Resources
217
- - 📖 **[Tutor Server Repository](https://github.com/TRIBE-INC/tutor-server-community-release)** - Open source telemetry server
218
- - 🚀 **[Latest CLI Releases](https://github.com/TRIBE-INC/releases)** - Download server binaries and release notes
219
- - 🔧 **[TRIBE Platform Docs](https://github.com/TRIBE-INC/0zen)** - Architecture and self-hosting guides
220
- - 📊 **[API Documentation](https://github.com/TRIBE-INC/tribe-api)** - REST endpoints for your self-hosted server
194
+ ### Privacy & Self-Hosting
195
+ - 🔒 **[Privacy & Security Policy](https://tribecode.ai/docs/privacy-security)** - Our privacy commitment
196
+ - 🏠 **[Self-Hosting Guide](https://github.com/TRIBE-INC/releases)** - Run your own infrastructure
197
+ - 📖 **[Tutor Server Source](https://github.com/TRIBE-INC/tutor-server-community-release)** - Open source telemetry server
198
+ - 🔧 **[Platform Docs](https://github.com/TRIBE-INC/0zen)** - Architecture and setup guides
221
199
 
222
- ### Community & Support
223
- - 💬 **Community:** Join discussions about privacy-first AI analytics
224
- - 🐛 **Issues:** [Report bugs or request privacy features](https://github.com/TRIBE-INC/releases/issues)
225
- - 📧 **Privacy Questions:** Contact us about data sovereignty and self-hosting
226
- - 📚 **Documentation Portal:** [tribecode.ai/docs](https://tribecode.ai/docs) - Comprehensive guides
200
+ ### Community
201
+ - 💬 **[GitHub Discussions](https://github.com/TRIBE-INC/releases/discussions)** - Community support
202
+ - 🐛 **[Issues](https://github.com/TRIBE-INC/releases/issues)** - Bug reports and feature requests
203
+ - 📧 **Support:** Questions about privacy and self-hosting
204
+ - 📚 **[Documentation Portal](https://tribecode.ai/docs)** - Comprehensive guides
227
205
 
228
206
  ---
229
207
 
230
- ## Privacy Commitment
231
-
232
- 🔒 **Your data sovereignty matters.** TRIBE CLI is designed with privacy-first principles:
233
-
234
- - **Local-by-default**: Core functionality works without data sharing
235
- - **Self-hosting ready**: Complete control over your analytics infrastructure
236
- - **Open source**: Transparent telemetry collection you can audit
237
- - **Anonymous operation**: Skip authentication for testing and development
238
- - **Zero tracking**: No analytics about your usage patterns in local mode
239
-
240
- ### Data Control Features
241
- - ✅ **Export your data** anytime in JSON format
242
- - ✅ **Delete cloud data** on demand (if using cloud service)
243
- - ✅ **Audit telemetry** - see exactly what data is collected
244
- - ✅ **Modify collection** - customize telemetry for your needs
245
-
246
- **Questions about privacy?** We're committed to transparency about data handling and self-hosting options.
247
-
248
- ---
249
-
250
- ## Typical Privacy-First Workflow
208
+ ## 🎉 Get Started Now
251
209
 
252
210
  ```bash
253
- # 1. Install and verify local operation
254
- npx @_xtribe/cli@latest --skip-auth --version
255
-
256
- # 2. Start anonymous telemetry collection
257
- npx @_xtribe/cli@latest --skip-auth enable
211
+ # Install TRIBE CLI
212
+ npx @_xtribe/cli@latest
258
213
 
259
- # 3. View your local analytics
260
- npx @_xtribe/cli@latest --skip-auth logs
261
-
262
- # 4. Check data stays local
263
- npx @_xtribe/cli@latest --skip-auth status
264
- # Confirms: "Telemetry Mode: Local-only (no remote data)"
214
+ # Start monitoring your AI development
215
+ tribe
265
216
  ```
266
217
 
267
- *Want cloud convenience with privacy protection? Our hosted service includes data deletion, export tools, and privacy controls. Local-first operation is always available.*
218
+ **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.
219
+
220
+ *Questions about privacy or self-hosting? Check our [Privacy Policy](https://tribecode.ai/docs/privacy-security) or reach out to the community.*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@_xtribe/cli",
3
- "version": "2.2.31",
3
+ "version": "2.2.33",
4
4
  "description": "TRIBE - Privacy-first AI development analytics. Self-host your telemetry, skip authentication, or run completely offline. Your data stays on your machine.",
5
5
  "main": "install-tribe.js",
6
6
  "bin": {