tide-commander 0.52.0 → 0.53.2
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/README.md
CHANGED
|
@@ -10,46 +10,71 @@
|
|
|
10
10
|
|
|
11
11
|
Tide Commander is a Claude Code and Codex orchestrator and manager that lets you deploy, control, and monitor multiple AI coding agents from a single visual interface. Spawn agents, assign tasks, and watch them work in real-time on an RTS-inspired 3D battlefield — or switch to a lightweight 2D canvas or a metrics dashboard.
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## 🚀 Getting Started
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
Requirements:
|
|
16
|
+
- Node.js 18+
|
|
17
|
+
- Claude Code CLI (`claude` command available in PATH)
|
|
18
|
+
- OpenAI Codex CLI compatibility
|
|
16
19
|
|
|
17
|
-
|
|
20
|
+
Install and run:
|
|
18
21
|
|
|
19
|
-
|
|
22
|
+
```bash
|
|
23
|
+
# Always install/update to latest published release
|
|
24
|
+
npm i -g tide-commander@latest
|
|
25
|
+
tide-commander start
|
|
26
|
+
```
|
|
20
27
|
|
|
21
|
-
|
|
28
|
+
Command lifecycle:
|
|
22
29
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
-
|
|
30
|
+
```bash
|
|
31
|
+
# Start in background (default)
|
|
32
|
+
tide-commander start
|
|
26
33
|
|
|
27
|
-
|
|
34
|
+
# Stop the background server
|
|
35
|
+
tide-commander stop
|
|
36
|
+
|
|
37
|
+
# Check whether server is running
|
|
38
|
+
tide-commander status
|
|
39
|
+
|
|
40
|
+
# Show the latest server logs
|
|
41
|
+
tide-commander logs
|
|
42
|
+
|
|
43
|
+
# Follow logs in real time
|
|
44
|
+
tide-commander logs --follow
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
CLI flags (for `start`):
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
tide-commander --help
|
|
51
|
+
tide-commander --foreground
|
|
52
|
+
tide-commander logs --lines 200
|
|
53
|
+
tide-commander --port 8080 --host 0.0.0.0
|
|
54
|
+
tide-commander --listen-all --port 8080
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## 🧑💻 Development Setup
|
|
58
|
+
|
|
59
|
+
Use this only if you are developing Tide Commander itself:
|
|
28
60
|
|
|
29
61
|
```bash
|
|
30
62
|
# Install dependencies
|
|
31
63
|
bun install
|
|
32
64
|
|
|
33
|
-
# Start
|
|
65
|
+
# Start dev frontend + backend
|
|
34
66
|
bun run dev
|
|
35
67
|
```
|
|
36
68
|
|
|
37
|
-
Open http://localhost:5173 in your browser (or your configured `VITE_PORT`)
|
|
69
|
+
Open http://localhost:5173 in your browser (or your configured `VITE_PORT`).
|
|
38
70
|
|
|
39
|
-
##
|
|
71
|
+
## 💡 Why Tide Commander?
|
|
40
72
|
|
|
41
|
-
|
|
42
|
-
npm i -g tide-commander
|
|
43
|
-
tide-commander
|
|
44
|
-
```
|
|
73
|
+
Managing multiple Claude Code terminals at the same time is painful. Tide Commander replaces that mess with a single visual UI where you can see every agent, their status, and their output at a glance.
|
|
45
74
|
|
|
46
|
-
|
|
75
|
+
Despite looking like a game, Tide Commander is a full-featured Claude Code GUI packed with developer tools: built-in file explorer with git diffs, conversation history with tool formatting, permission controls, and a command palette. For many workflows, an IDE becomes almost unnecessary.
|
|
47
76
|
|
|
48
|
-
|
|
49
|
-
tide-commander --port 8080 --host 0.0.0.0
|
|
50
|
-
# or
|
|
51
|
-
tide-commander --listen-all --port 8080
|
|
52
|
-
```
|
|
77
|
+
Think of it like having a team of AI developers at your command. Assign one agent to investigate a bug while another implements a feature. Watch them work in real-time, send follow-up commands, and keep your project moving forward on multiple fronts.
|
|
53
78
|
|
|
54
79
|
## 🎖️ Agent Concepts
|
|
55
80
|
|
|
@@ -345,7 +370,7 @@ Planned features and improvements — contributions and feedback welcome:
|
|
|
345
370
|
|
|
346
371
|
- [ ] **Test Coverage** — Unit, integration, and E2E tests (currently minimal)
|
|
347
372
|
- [ ] **Multilingual Support** — i18n with translations for Chinese, French, Spanish, and more
|
|
348
|
-
- [x] **Codex Integration
|
|
373
|
+
- [x] **Codex Integration** — Compatible with OpenAI Codex CLI alongside Claude Code
|
|
349
374
|
- [ ] **Buildings Plugin System** — External plugin API for community-built building types
|
|
350
375
|
- [ ] **API Documentation** — OpenAPI/Swagger spec for the REST and WebSocket APIs
|
|
351
376
|
- [ ] **Observability** — Error tracking, logging aggregation, and performance monitoring
|