@cluesmith/codev 2.0.0-rc.3 → 2.0.0-rc.33

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:**
@@ -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,19 +116,17 @@ 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:**
@@ -306,16 +308,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 +330,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 +358,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 +391,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.
 
 #### af tower start
 
@@ -422,6 +403,7 @@ af tower start [options]
 
 **Options:**
 - `-p, --port <port>` - Port to run on (default: 4100)
+- `-w, --web` - Enable web access mode (requires CODEV_WEB_KEY)
 
 #### af tower stop
 
@@ -495,7 +477,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 +504,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/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,17 +87,7 @@ 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
 

package/skeleton/resources/workflow-reference.md

@@ -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