@cluesmith/codev 2.0.0-rc.8 → 2.0.0

package/skeleton/resources/commands/agent-farm.md

@@ -18,12 +18,16 @@ af <command> [options]
 
 ## Commands
 
-### af start
+### af dash
+
+Project dashboard commands - start/stop the architect dashboard for this project.
+
+#### af dash start
 
 Start the architect dashboard.
 
 ```bash
-af start [options]
+af dash start [options]
 ```
 
 **Options:**
@@ -39,7 +43,7 @@ af start [options]
 Starts the agent-farm dashboard with:
 - Architect terminal (Claude session with architect role)
 - Web-based UI for monitoring builders
-- tmux session management
+- Terminal session management (shellper processes)
 
 The dashboard is accessible via browser at `http://localhost:<port>`.
 
@@ -47,16 +51,16 @@ The dashboard is accessible via browser at `http://localhost:<port>`.
 
 ```bash
 # Start with defaults
-af start
+af dash start
 
 # Start with custom port
-af start -p 4300
+af dash start -p 4300
 
 # Start with specific command
-af start -c "claude --model opus"
+af dash start -c "claude --model opus"
 
 # Start on remote machine
-af start --remote user@host
+af dash start --remote user@host
 ```
 
 #### Remote Access
@@ -65,13 +69,13 @@ Start Agent Farm on a remote machine and access it from your local workstation w
 
 ```bash
 # On your local machine - one command does everything:
-af start --remote user@remote-host
+af dash start --remote user@remote-host
 
 # Or with explicit project path:
-af start --remote user@remote-host:/path/to/project
+af dash start --remote user@remote-host:/path/to/project
 
 # With custom port:
-af start --remote user@remote-host --port 4300
+af dash start --remote user@remote-host --port 4300
 ```
 
 This single command:
@@ -112,26 +116,23 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # DEPRECATED: Exposes dashboard without authentication
-af start --allow-insecure-remote
+af dash start --allow-insecure-remote
 ```
 
 The `--allow-insecure-remote` flag binds to `0.0.0.0` with no authentication. Use `--remote` instead for secure access via SSH.
 
----
+#### af dash stop
 
-### af stop
-
-Stop all agent farm processes.
+Stop all agent farm processes for this project.
 
 ```bash
-af stop
+af dash stop
 ```
 
 **Description:**
 
 Stops all running agent-farm processes including:
-- tmux sessions
-- ttyd processes
+- Terminal sessions (shellper processes)
 - Dashboard servers
 
 Does NOT clean up worktrees - use `af cleanup` for that.
@@ -306,16 +307,14 @@ af open src/auth/login.ts
 
 ---
 
-### af util
+### af shell
 
 Spawn a utility shell terminal.
 
 ```bash
-af util [options]
+af shell [options]
 ```
 
-**Aliases:** `af shell`
-
 **Options:**
 - `-n, --name <name>` - Name for the shell terminal
 
@@ -330,10 +329,10 @@ Opens a general-purpose shell terminal in the dashboard. Useful for:
 
 ```bash
 # Open utility shell
-af util
+af shell
 
 # Open with custom name
-af util -n "test-runner"
+af shell -n "test-runner"
 ```
 
 ---
@@ -358,25 +357,6 @@ af rename 0042 "auth-rework"
 
 ---
 
-### af tutorial
-
-Interactive tutorial for new users.
-
-```bash
-af tutorial [options]
-```
-
-**Options:**
-- `--reset` - Start tutorial fresh
-- `--skip` - Skip current step
-- `--status` - Show tutorial progress
-
-**Description:**
-
-Walks through the basics of using agent-farm with guided steps.
-
----
-
 ### af ports
 
 Manage global port registry.
@@ -410,7 +390,7 @@ Removes entries for projects that no longer exist.
 
 ### af tower
 
-Manage the tower dashboard.
+Manage the cross-project tower dashboard. Tower shows all agent-farm instances across projects and provides cloud connectivity via codevos.ai.
 
 #### af tower start
 
@@ -434,6 +414,43 @@ af tower stop [options]
 **Options:**
 - `-p, --port <port>` - Port to stop (default: 4100)
 
+#### af tower register
+
+Register this tower with codevos.ai for remote access.
+
+```bash
+af tower register [options]
+```
+
+**Options:**
+- `--reauth` - Re-authenticate without changing tower name
+- `-p, --port <port>` - Tower port to signal after registration (default: 4100)
+
+#### af tower deregister
+
+Remove this tower's registration from codevos.ai.
+
+```bash
+af tower deregister [options]
+```
+
+**Options:**
+- `-p, --port <port>` - Tower port to signal after deregistration (default: 4100)
+
+#### af tower status
+
+Show tower status including cloud connection info.
+
+```bash
+af tower status [options]
+```
+
+**Options:**
+- `-p, --port <port>` - Tower port (default: 4100)
+
+**Environment Variables:**
+- `CODEVOS_URL` - Override the codevos.ai server URL (default: `https://codevos.ai`). Useful for local development or staging.
+
 ---
 
 ### af db
@@ -495,7 +512,7 @@ af db stats [options]
 
 ## Configuration
 
-Customize commands via `codev/config.json`:
+Customize commands via `af-config.json` at the project root:
 
 ```json
 {
@@ -522,7 +539,7 @@ af spawn -p 0042 --builder-cmd "claude --model haiku"
 |------|-------------|
 | `.agent-farm/state.json` | Project runtime state |
 | `~/.agent-farm/ports.json` | Global port registry |
-| `codev/config.json` | Project configuration |
+| `af-config.json` | Agent Farm configuration (project root) |
 
 ---
 

package/skeleton/resources/commands/codev.md

@@ -95,7 +95,6 @@ Verifies that all required dependencies are installed and properly configured:
 
 **Core Dependencies (required):**
 - Node.js (>= 18.0.0)
-- tmux (>= 3.0)
 - ttyd (>= 1.7.0)
 - git (>= 2.5.0)
 - gh (GitHub CLI, authenticated)
@@ -123,7 +122,6 @@ Codev Doctor - Checking your environment
 Core Dependencies (required for Agent Farm)
 
   ✓ Node.js      20.10.0
-  ✓ tmux         3.4
   ✓ ttyd         1.7.4
   ✓ git          2.42.0
   ✓ gh           authenticated

package/skeleton/resources/commands/overview.md

@@ -21,7 +21,7 @@ codev adopt
 codev doctor
 
 # Start the architect dashboard
-af start
+af dash start
 
 # Consult an AI model about a spec
 consult -m gemini spec 42
@@ -46,7 +46,6 @@ This installs all three commands globally: `codev`, `af`, and `consult`.
 | `codev doctor` | Check system dependencies |
 | `codev update` | Update codev templates and protocols |
 | `codev import <source>` | AI-assisted protocol import from other projects |
-| `codev tower` | Cross-project dashboard |
 
 See [codev.md](codev.md) for full documentation.
 
@@ -54,14 +53,15 @@ See [codev.md](codev.md) for full documentation.
 
 | Command | Description |
 |---------|-------------|
-| `af start` | Start the architect dashboard |
-| `af stop` | Stop all agent farm processes |
+| `af dash start` | Start the architect dashboard |
+| `af dash stop` | Stop all agent farm processes |
 | `af spawn` | Spawn a new builder |
 | `af status` | Show status of all agents |
 | `af cleanup` | Clean up a builder worktree |
 | `af send` | Send instructions to a builder |
 | `af open` | Open file annotation viewer |
-| `af util` | Spawn a utility shell |
+| `af shell` | Spawn a utility shell |
+| `af tower` | Cross-project dashboard |
 
 See [agent-farm.md](agent-farm.md) for full documentation.
 
@@ -87,21 +87,11 @@ All codev commands support:
 
 ## Configuration
 
-Customize agent-farm commands via `codev/config.json`:
-
-```json
-{
-  "shell": {
-    "architect": "claude --model opus",
-    "builder": "claude --model sonnet",
-    "shell": "bash"
-  }
-}
-```
+Agent Farm is configured via `af-config.json` at the project root. Created during `codev init` or `codev adopt`. Override via CLI flags: `--architect-cmd`, `--builder-cmd`, `--shell-cmd`.
 
 ## Related Documentation
 
-- [SPIDER Protocol](../protocols/spider/protocol.md) - Multi-phase development workflow
+- [SPIR Protocol](../protocols/spir/protocol.md) - Multi-phase development workflow
 - [TICK Protocol](../protocols/tick/protocol.md) - Fast amendment workflow
 - [Architect Role](../roles/architect.md) - Architect responsibilities
 - [Builder Role](../roles/builder.md) - Builder responsibilities

package/skeleton/resources/workflow-reference.md

@@ -1,6 +1,6 @@
 # Architect-Builder Workflow Reference
 
-Quick reference for the 7-stage project workflow. For protocol details, see `codev/protocols/spider/protocol.md`.
+Quick reference for the 7-stage project workflow. For protocol details, see `codev/protocols/spir/protocol.md`.
 
 ## Workflow Overview
 
@@ -77,7 +77,7 @@ AI agents must stop and wait for human action at these gates.
 
 ```bash
 # Start the dashboard
-af start
+af dash start
 
 # Spawn a builder for a project
 af spawn -p 0044
@@ -95,7 +95,7 @@ af open codev/specs/0044-name.md
 af cleanup -p 0044
 
 # Stop everything
-af stop
+af dash stop
 ```
 
 ### Builder Commands
@@ -236,7 +236,7 @@ af cleanup -p XXXX --force
 
 ## Related Documentation
 
-- Full SPIDER protocol: `codev/protocols/spider/protocol.md`
+- Full SPIR protocol: `codev/protocols/spir/protocol.md`
 - Builder role: `codev/roles/builder.md`
 - Architect role: `codev/roles/architect.md`
 - Consultant role: `codev/roles/consultant.md`