@_xtribe/cli 1.0.53 → 1.0.54
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.
- package/package.json +1 -1
- package/AUTOLAUNCH_IMPLEMENTATION.md +0 -168
- package/README.md +0 -146
package/package.json
CHANGED
|
@@ -1,168 +0,0 @@
|
|
|
1
|
-
# Auto-Launch Implementation Guide
|
|
2
|
-
|
|
3
|
-
## Overview
|
|
4
|
-
|
|
5
|
-
This implementation adds automatic launching of the Tribe interactive UI after installation, providing a seamless onboarding experience for new users.
|
|
6
|
-
|
|
7
|
-
## Files Created
|
|
8
|
-
|
|
9
|
-
1. **install-tribe-autolaunch.js** - Core auto-launch functionality
|
|
10
|
-
- Detection logic for when to auto-launch
|
|
11
|
-
- Cluster status checking
|
|
12
|
-
- First-time welcome experience
|
|
13
|
-
- Interactive UI launching
|
|
14
|
-
|
|
15
|
-
2. **install-tribe-with-autolaunch.js** - Enhanced installer wrapper
|
|
16
|
-
- Integrates with existing installer
|
|
17
|
-
- Adds command-line flags for control
|
|
18
|
-
|
|
19
|
-
3. **test-autolaunch.js** - Testing utility
|
|
20
|
-
- Verifies auto-launch logic
|
|
21
|
-
- Tests different scenarios
|
|
22
|
-
|
|
23
|
-
## Implementation Status
|
|
24
|
-
|
|
25
|
-
✅ **Completed**
|
|
26
|
-
- Auto-launch detection logic
|
|
27
|
-
- First-time install detection
|
|
28
|
-
- TTY environment checking
|
|
29
|
-
- CI environment detection
|
|
30
|
-
- Command-line flag support (--launch, --no-launch)
|
|
31
|
-
- Cluster status checking
|
|
32
|
-
- Welcome message for first-time users
|
|
33
|
-
- Error handling and fallback
|
|
34
|
-
|
|
35
|
-
✅ **No Hallucinations Found**
|
|
36
|
-
- The plan correctly references actual components
|
|
37
|
-
- The tribe CLI exists with interactive mode
|
|
38
|
-
- Agent personalities are implemented
|
|
39
|
-
- ASCII banner is real
|
|
40
|
-
|
|
41
|
-
## How It Works
|
|
42
|
-
|
|
43
|
-
### Auto-Launch Decision Flow
|
|
44
|
-
```
|
|
45
|
-
Installation Complete
|
|
46
|
-
|
|
|
47
|
-
v
|
|
48
|
-
Is Interactive Terminal (TTY)?
|
|
49
|
-
| |
|
|
50
|
-
YES NO --> Show manual instructions
|
|
51
|
-
|
|
|
52
|
-
v
|
|
53
|
-
Is CI Environment?
|
|
54
|
-
| |
|
|
55
|
-
NO YES --> Skip auto-launch
|
|
56
|
-
|
|
|
57
|
-
v
|
|
58
|
-
Check command flags
|
|
59
|
-
|
|
|
60
|
-
v
|
|
61
|
-
--no-launch? --> Skip
|
|
62
|
-
--launch? --> Force launch
|
|
63
|
-
|
|
|
64
|
-
v
|
|
65
|
-
First time install?
|
|
66
|
-
| |
|
|
67
|
-
YES NO --> Skip (unless --launch)
|
|
68
|
-
|
|
|
69
|
-
v
|
|
70
|
-
Check/Start Cluster
|
|
71
|
-
|
|
|
72
|
-
v
|
|
73
|
-
Show Welcome Message
|
|
74
|
-
|
|
|
75
|
-
v
|
|
76
|
-
Launch Interactive UI
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### Integration Points
|
|
80
|
-
|
|
81
|
-
The auto-launch can be integrated into the existing installer in two ways:
|
|
82
|
-
|
|
83
|
-
#### Option 1: Direct Integration
|
|
84
|
-
Add to the end of successful installation in `install-tribe.js`:
|
|
85
|
-
|
|
86
|
-
```javascript
|
|
87
|
-
// After "TRIBE is ready!" message
|
|
88
|
-
if (require('./install-tribe-autolaunch.js').shouldAutoLaunch()) {
|
|
89
|
-
await require('./install-tribe-autolaunch.js').handleAutoLaunch();
|
|
90
|
-
}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
#### Option 2: Wrapper Script
|
|
94
|
-
Use `install-tribe-with-autolaunch.js` as the main entry point:
|
|
95
|
-
|
|
96
|
-
```json
|
|
97
|
-
// In package.json
|
|
98
|
-
{
|
|
99
|
-
"bin": {
|
|
100
|
-
"install-tribe": "./install-tribe-with-autolaunch.js"
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
## Usage
|
|
106
|
-
|
|
107
|
-
### For End Users
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
# First-time install - auto-launches interactive UI
|
|
111
|
-
npx @_xtribe/cli
|
|
112
|
-
|
|
113
|
-
# Skip auto-launch
|
|
114
|
-
npx @_xtribe/cli --no-launch
|
|
115
|
-
|
|
116
|
-
# Force auto-launch (even if not first time)
|
|
117
|
-
npx @_xtribe/cli --launch
|
|
118
|
-
|
|
119
|
-
# Launch in simple mode
|
|
120
|
-
npx @_xtribe/cli --simple
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
### For Testing
|
|
124
|
-
|
|
125
|
-
```bash
|
|
126
|
-
# Test auto-launch logic
|
|
127
|
-
node test-autolaunch.js
|
|
128
|
-
|
|
129
|
-
# Test with actual launch (requires tribe installed)
|
|
130
|
-
node test-autolaunch.js --test-launch
|
|
131
|
-
|
|
132
|
-
# Test in different scenarios
|
|
133
|
-
CI=true node test-autolaunch.js
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
## Benefits
|
|
137
|
-
|
|
138
|
-
1. **Zero-to-Magic Experience**: Users go from `npx @_xtribe/cli` directly into the interactive UI
|
|
139
|
-
2. **Smart Detection**: Only auto-launches when appropriate
|
|
140
|
-
3. **User Control**: Can be disabled with flags
|
|
141
|
-
4. **First-Time Experience**: Special welcome for new users
|
|
142
|
-
5. **Error Recovery**: Falls back gracefully if launch fails
|
|
143
|
-
|
|
144
|
-
## Next Steps
|
|
145
|
-
|
|
146
|
-
To activate auto-launch in production:
|
|
147
|
-
|
|
148
|
-
1. **Test thoroughly** in different environments
|
|
149
|
-
2. **Update package.json** to use the enhanced installer
|
|
150
|
-
3. **Document** the new flags in README
|
|
151
|
-
4. **Consider A/B testing** to measure impact
|
|
152
|
-
|
|
153
|
-
## Configuration
|
|
154
|
-
|
|
155
|
-
Future enhancement: Add configuration file support:
|
|
156
|
-
|
|
157
|
-
```json
|
|
158
|
-
// ~/.tribe/config.json
|
|
159
|
-
{
|
|
160
|
-
"autoLaunch": {
|
|
161
|
-
"enabled": true,
|
|
162
|
-
"firstTimeOnly": true,
|
|
163
|
-
"mode": "interactive" // or "simple"
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
This implementation provides a delightful onboarding experience while maintaining full control and compatibility.
|
package/README.md
DELETED
|
@@ -1,146 +0,0 @@
|
|
|
1
|
-
# TRIBE CLI - Zero to Productive in One Command
|
|
2
|
-
|
|
3
|
-
TRIBE is an AI-powered multi-agent development system that manages your entire development workflow. From project creation to task implementation and PR reviews, TRIBE's AI agents handle it all.
|
|
4
|
-
|
|
5
|
-
## 🚀 One-Command Installation
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
npx @_xtribe/cli
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
That's it! This single command works on macOS, Linux, and Windows (WSL2).
|
|
12
|
-
|
|
13
|
-
**What it does:**
|
|
14
|
-
- ✅ Detects your platform automatically
|
|
15
|
-
- ✅ Installs all required tools (kubectl, TRIBE CLI)
|
|
16
|
-
- ✅ Sets up Kubernetes for your platform:
|
|
17
|
-
- **macOS**: Colima with Kubernetes
|
|
18
|
-
- **Linux**: K3s (lightweight Kubernetes)
|
|
19
|
-
- **Windows**: Guides to WSL2 setup
|
|
20
|
-
- ✅ Deploys the complete TRIBE cluster
|
|
21
|
-
- ✅ Configures your environment
|
|
22
|
-
- ✅ Guides you through creating your first project
|
|
23
|
-
|
|
24
|
-
## 🎯 What is TRIBE?
|
|
25
|
-
|
|
26
|
-
TRIBE is a complete development ecosystem where AI agents:
|
|
27
|
-
- 📝 Implement features based on your descriptions
|
|
28
|
-
- 🔧 Fix bugs autonomously
|
|
29
|
-
- 🔀 Create pull requests
|
|
30
|
-
- 👀 Handle code reviews
|
|
31
|
-
- 🚀 Manage the entire development lifecycle
|
|
32
|
-
|
|
33
|
-
## 💡 Quick Start
|
|
34
|
-
|
|
35
|
-
After installation, just run:
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
tribe
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
The interactive CLI will:
|
|
42
|
-
1. **First time?** Guide you through creating your first project
|
|
43
|
-
2. **Returning?** Show your projects, tasks, and agent activity
|
|
44
|
-
|
|
45
|
-
### Creating Tasks
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
tribe create-task
|
|
49
|
-
# Select project, describe what you want built
|
|
50
|
-
# An AI agent picks it up and implements it!
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
### Reviewing PRs
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
tribe review-task
|
|
57
|
-
# See PRs created by agents
|
|
58
|
-
# Review diffs, add comments, merge
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## 🛠️ System Requirements
|
|
62
|
-
|
|
63
|
-
### Supported Platforms
|
|
64
|
-
- **macOS** (Intel & Apple Silicon)
|
|
65
|
-
- **Linux** (Ubuntu, Debian, Fedora, etc.)
|
|
66
|
-
- **Windows** - Use WSL2 with Ubuntu
|
|
67
|
-
|
|
68
|
-
### Hardware Requirements
|
|
69
|
-
- **4GB RAM** minimum (8GB recommended)
|
|
70
|
-
- **20GB disk space**
|
|
71
|
-
- **Node.js 16+**
|
|
72
|
-
|
|
73
|
-
## 📚 Common Commands
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
tribe # Interactive mode
|
|
77
|
-
tribe status # Check system status
|
|
78
|
-
tribe create-task # Create a new task
|
|
79
|
-
tribe review-task # Review agent PRs
|
|
80
|
-
tribe list-projects # Show all projects
|
|
81
|
-
tribe list-agents # Show agent status
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
## 🔧 Architecture
|
|
85
|
-
|
|
86
|
-
TRIBE runs a local Kubernetes cluster with:
|
|
87
|
-
- **Bridge** - API gateway and orchestrator
|
|
88
|
-
- **TaskMaster** - Task queue and agent coordinator
|
|
89
|
-
- **Claude Agents** - AI workers powered by Claude
|
|
90
|
-
- **Gitea** - Local Git server for repositories
|
|
91
|
-
- **PostgreSQL** - Database for state management
|
|
92
|
-
|
|
93
|
-
## 🤝 Contributing
|
|
94
|
-
|
|
95
|
-
TRIBE is open source! Visit our [GitHub repository](https://github.com/0zen/0zen) to contribute.
|
|
96
|
-
|
|
97
|
-
## 📖 Documentation
|
|
98
|
-
|
|
99
|
-
For detailed documentation, visit the [TRIBE Flow Guide](https://github.com/0zen/0zen/blob/main/TRIBE-SYSTEM-FLOW-GUIDE.md).
|
|
100
|
-
|
|
101
|
-
## 🆘 Troubleshooting
|
|
102
|
-
|
|
103
|
-
### Cluster not starting?
|
|
104
|
-
|
|
105
|
-
**macOS:**
|
|
106
|
-
```bash
|
|
107
|
-
# Check if Colima is running
|
|
108
|
-
colima status
|
|
109
|
-
|
|
110
|
-
# Start manually if needed
|
|
111
|
-
colima start --kubernetes
|
|
112
|
-
tribe start
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
**Linux:**
|
|
116
|
-
```bash
|
|
117
|
-
# Check if K3s is running
|
|
118
|
-
sudo systemctl status k3s
|
|
119
|
-
|
|
120
|
-
# Start manually if needed
|
|
121
|
-
sudo systemctl start k3s
|
|
122
|
-
tribe start
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### Port conflicts?
|
|
126
|
-
```bash
|
|
127
|
-
# Check what's using ports
|
|
128
|
-
lsof -i :30080
|
|
129
|
-
lsof -i :3456
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### Reset everything?
|
|
133
|
-
```bash
|
|
134
|
-
# Stop cluster
|
|
135
|
-
colima stop
|
|
136
|
-
|
|
137
|
-
# Remove TRIBE namespace
|
|
138
|
-
kubectl delete namespace tribe-system
|
|
139
|
-
|
|
140
|
-
# Start fresh
|
|
141
|
-
tribe start
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
## 📄 License
|
|
145
|
-
|
|
146
|
-
MIT License - see [LICENSE](https://github.com/0zen/0zen/blob/main/LICENSE) for details.
|