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
- ## 💡 Why Tide Commander?
13
+ ## 🚀 Getting Started
14
14
 
15
- 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.
15
+ Requirements:
16
+ - Node.js 18+
17
+ - Claude Code CLI (`claude` command available in PATH)
18
+ - OpenAI Codex CLI compatibility
16
19
 
17
- 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.
20
+ Install and run:
18
21
 
19
- 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.
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
- ## 📋 Prerequisites
28
+ Command lifecycle:
22
29
 
23
- - Node.js 18+ or Bun
24
- - Claude Code CLI (`claude` command available in PATH)
25
- - OpenAI Codex CLI compatibility (experimental)
30
+ ```bash
31
+ # Start in background (default)
32
+ tide-commander start
26
33
 
27
- ## 🚀 Getting Started
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 the application
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`) and you're ready to go!
69
+ Open http://localhost:5173 in your browser (or your configured `VITE_PORT`).
38
70
 
39
- ## 📦 Global npm Install
71
+ ## 💡 Why Tide Commander?
40
72
 
41
- ```bash
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
- CLI flags:
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
- ```bash
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 (Experimental)** — Compatible with OpenAI Codex CLI alongside Claude Code
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