@kaiba-cloud/orbital 0.0.3 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # Orbital
 
-Orbital runs teams of agents on your machine. A team has a lead and members. You give the team a mission, and you watch it live in your terminal or in Claude Code.
+Orbital is a harness runner for agent harnesses. It lets agents on different harnesses (Claude Code, Codex, Pi or your own) work as one team and talk to each other. You use it to build agent factories.
 
 ## Install
 
@@ -18,6 +18,20 @@ Orbital runs teams of agents on your machine. A team has a lead and members. You
 
 3. In Claude Code, run `/reload-plugins`, then `/orbital` to open the pane.
 
+## Update the Claude Code mod
+
+The Claude adapter owns the mod. `orbital install claude` writes the mod when it is missing and refreshes it when it is old. It writes only the files that changed and reports each change. If nothing changed, it writes nothing.
+
+1. After you update orbital, run the install again in your repository.
+
+   ```bash
+   orbital install claude
+   ```
+
+2. In Claude Code, run `/reload-plugins`.
+
+Codex and Pi have no mod. `orbital install codex` and `orbital install pi` connect those harnesses the same way, and a second run writes nothing.
+
 ## Skills
 
 - The orbital-team skill comes with the mod. It teaches Claude to work with teams and missions.
@@ -88,8 +102,10 @@ Paste this prompt into Claude Code in your repository:
 
 ## Keep it running
 
-Each node runs in the background under a supervisor. Closing the view (`q`, Ctrl+C or a closed terminal) stops no node. Only `orbital down` stops the nodes.
+Each node runs in the background under a supervisor. Closing the view (`q`, Ctrl+C or a closed terminal) stops no node. To stop a node, use the keys of the view or `orbital down`.
 
+- In the view, `S` stops the selected node and `R` restarts it on the installed orbital, so it picks up a new version. `Q` stops every node of the view and closes the view. Each key asks for `y` first.
+- A restart keeps the work going: a mission that was active or waiting before the restart goes on by itself.
 - If a node crashes, its supervisor starts it again and the view says why. A mission that was active comes back paused. Resume it with `orbital mission resume <id>`.
 - A second `orbital up` shows the nodes that run. `orbital up --new` starts a separate node for a separate run, such as `<node>-2`.
 - To start the nodes at each login, install the login service. It uses launchd on macOS and systemd on Linux, and it needs no sudo.
@@ -116,6 +132,14 @@ Each agent session that starts its own chrome-devtools server makes Chrome ask y
   orbital browser install --revert
   ```
 
+## Plugins
+
+A plugin adds ports to a node, and it can add commands to this CLI.
+`orbital plugin add <source>` names a plugin in `orbital.yaml`.
+A plugin `acme` that declares a `login` command runs with `orbital acme login`.
+`orbital help` lists the commands of each plugin, and a built-in command always wins.
+To write a plugin, use the plugin builder skill and `orbital plugin new`.
+
 ## Commands
 
 | Command | What it does |