feat: genie agent system — pane colors, hook dispatch, identity inject & onboarding (v3.260309.1)

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "genie",
-      "version": "3.260302.2",
+      "version": "3.260309.1",
       "source": "./plugins/genie",
       "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
     }

TEAM_LEAD_PROMPT.md

@@ -1,43 +1,43 @@
 <GENIE_CLI>
-# Genie CLI — MANDATORY Worker Orchestration
+# Genie CLI — MANDATORY Agent Orchestration
 
-You are a team-lead in a **genie-managed environment**. ALL worker spawning, messaging, and team management MUST go through the genie CLI via Bash.
+You are a team-lead in a **genie-managed environment**. ALL agent spawning, messaging, and team management MUST go through the genie CLI via Bash.
 
 ## CRITICAL: NEVER Use These Native Tools
 
-NEVER use the `Agent` tool to spawn agents or subagents. Use `genie worker spawn` instead.
-NEVER use `SendMessage` to communicate with workers. Use `genie msg send` instead.
+NEVER use the `Agent` tool to spawn agents or subagents. Use `genie agent spawn` instead.
+NEVER use `SendMessage` to communicate with agents. Use `genie send` instead.
 NEVER use `TeamCreate` or `TeamDelete`. Use `genie team ensure` / `genie team delete` instead.
 
 If you catch yourself about to use Agent, SendMessage, TeamCreate, or TeamDelete — STOP and use the genie CLI equivalent below.
 
-## Workers
+## Agents
 
 ```bash
-# Spawn a worker (ALWAYS use this instead of Agent tool)
-genie worker spawn --role <role>                    # implementor, tests, review, fix, refactor
-genie worker spawn --role <role> --skill <skill>    # With specific skill
+# Spawn an agent (ALWAYS use this instead of Agent tool)
+genie agent spawn --role <role>                    # implementor, tests, review, fix, refactor
+genie agent spawn --role <role> --skill <skill>    # With specific skill
 
 # Monitor
-genie worker list                           # List all workers
-genie worker dashboard                      # Live dashboard
-genie worker history <worker>               # Session history
-genie worker read <worker> --follow         # Tail terminal output
+genie agent list                           # List all agents
+genie agent dashboard                      # Live dashboard
+genie agent history <agent>                # Session history
+genie agent read <agent> --follow          # Tail terminal output
 
 # Control
-genie worker kill <id>                      # Force kill
-genie worker suspend <id>                   # Suspend (preserves session)
-genie worker exec <worker> "<cmd>"          # Run command in worker pane
-genie worker answer <worker> <choice>       # Answer prompt (1-9 or text:...)
+genie agent kill <id>                      # Force kill
+genie agent suspend <id>                   # Suspend (preserves session)
+genie agent exec <agent> "<cmd>"           # Run command in agent pane
+genie agent answer <agent> <choice>        # Answer prompt (1-9 or text:...)
 ```
 
 ## Messaging
 
 ```bash
-# Send message to a worker (ALWAYS use this instead of SendMessage)
-genie msg send "<text>" --to <worker>       # Send to specific worker
-genie msg inbox <worker>                    # View worker inbox
-genie msg inbox <worker> --unread           # Unread only
+# Send message to an agent (ALWAYS use this instead of SendMessage)
+genie send "<text>" --to <agent>            # Send to specific agent
+genie inbox <agent>                         # View agent inbox
+genie inbox <agent> --unread                # Unread only
 ```
 
 ## Teams
@@ -51,19 +51,19 @@ genie team delete <name>                    # Delete team
 ## Typical Flow
 
 ```bash
-# 1. Spawn a worker
-genie worker spawn --role implementor
+# 1. Spawn an agent
+genie agent spawn --role implementor
 
 # 2. Monitor
-genie worker list
+genie agent list
 
 # 3. Send instructions
-genie msg send "Implement endpoint X" --to <worker-name>
+genie send "Implement endpoint X" --to <agent-name>
 
 # 4. Check progress
-genie worker history <worker-name>
+genie agent history <agent-name>
 
 # 5. Shut down
-genie worker kill <worker-id>
+genie agent kill <agent-id>
 ```
 </GENIE_CLI>

docs/CO-ORCHESTRATION-GUIDE.md

@@ -15,7 +15,7 @@ Human (Orchestrator)
     ├── genie work bd-2  ──▶  Worker 2 (Claude in pane %2)
     │                              └── worktree: .worktrees/bd-2/
     │
-    └── genie worker list ──▶  Status dashboard
+    └── genie agent list ──▶  Status dashboard
 ```
 
 ## Prerequisites
@@ -39,13 +39,13 @@ bd create "Update API documentation"
 genie work bd-1
 
 # 4. Check worker status
-genie worker list
+genie agent list
 
 # 5. When worker needs approval
-genie worker approve
+genie agent approve
 
 # 6. When done, close the issue
-genie worker close bd-1
+genie agent close bd-1
 ```
 
 ## Detailed Workflow
@@ -99,10 +99,10 @@ genie work next
 
 ```bash
 # Check all workers
-genie worker list
+genie agent list
 
 # JSON output for scripting
-genie worker list --json
+genie agent list --json
 ```
 
 **Worker States:**
@@ -119,14 +119,14 @@ genie worker list --json
 
 **Approve permissions:**
 ```bash
-genie worker approve           # Approve pending permission
-genie worker approve --start   # Start auto-approve engine
+genie agent approve           # Approve pending permission
+genie agent approve --start   # Start auto-approve engine
 ```
 
 **Answer questions:**
 ```bash
-genie worker answer bd-1 1              # Select option 1
-genie worker answer bd-1 "text:custom"  # Provide custom text answer
+genie agent answer bd-1 1              # Select option 1
+genie agent answer bd-1 "text:custom"  # Provide custom text answer
 ```
 
 ### Phase 5: Closing Issues
@@ -135,7 +135,7 @@ When a worker completes its task:
 
 ```bash
 # Close issue and cleanup worker
-genie worker close bd-1
+genie agent close bd-1
 
 # Options:
 #   --merge          Merge worktree branch to main before cleanup
@@ -156,7 +156,7 @@ genie worker close bd-1
 If a worker is stuck or needs to be terminated:
 
 ```bash
-genie worker kill bd-1
+genie agent kill bd-1
 ```
 
 Note: This does NOT close the issue. The task remains `in_progress` in beads.
@@ -190,7 +190,7 @@ bd update bd-2 --blocked-by bd-1
 genie work bd-1
 
 # When bd-1 completes, bd-2 becomes ready
-genie worker close bd-1
+genie agent close bd-1
 genie work next  # Picks bd-2
 ```
 
@@ -208,7 +208,7 @@ genie work bd-2
 genie work bd-3
 
 # Monitor all
-genie worker list
+genie agent list
 ```
 
 ### Pattern 3: Review and Iterate
@@ -231,7 +231,7 @@ genie work bd-1
 ### Worker shows as dead but pane exists
 ```bash
 # The registry may be out of sync
-genie worker kill <worker-id>  # Clean up registry entry
+genie agent kill <worker-id>  # Clean up registry entry
 genie work <task-id>           # Start fresh
 ```
 
@@ -256,7 +256,7 @@ bd daemon start --auto-commit
 1. **Clear issue titles**: Workers use titles as context
 2. **One task per worker**: Keep issues focused
 3. **Use dependencies**: `--blocked-by` prevents premature work
-4. **Review before closing**: Check worker output before `genie worker close`
+4. **Review before closing**: Check worker output before `genie agent close`
 5. **Use worktrees**: They provide isolation and can be reviewed independently
 6. **Keep daemon running**: Ensures beads state is synced to git
 
@@ -266,16 +266,16 @@ bd daemon start --auto-commit
 |---------|-------------|
 | `genie work <bd-id>` | Spawn worker for issue |
 | `genie work next` | Work on next ready issue |
-| `genie worker list` | List all workers |
-| `genie worker approve` | Approve permission / manage auto-approve |
-| `genie worker answer <id> <choice>` | Answer question |
-| `genie worker history <id>` | Compressed session catch-up |
-| `genie worker events [pane-id]` | Stream Claude Code events |
-| `genie worker close <id>` | Close issue and cleanup |
-| `genie worker ship <id>` | Mark done, merge, cleanup |
-| `genie worker kill <id>` | Force kill worker |
-| `genie worker read <id>` | Read worker pane output |
-| `genie worker exec <id> <cmd>` | Execute command in worker pane |
+| `genie agent list` | List all workers |
+| `genie agent approve` | Approve permission / manage auto-approve |
+| `genie agent answer <id> <choice>` | Answer question |
+| `genie agent history <id>` | Compressed session catch-up |
+| `genie agent events [pane-id]` | Stream Claude Code events |
+| `genie agent close <id>` | Close issue and cleanup |
+| `genie agent ship <id>` | Mark done, merge, cleanup |
+| `genie agent kill <id>` | Force kill worker |
+| `genie agent read <id>` | Read worker pane output |
+| `genie agent exec <id> <cmd>` | Execute command in worker pane |
 | `genie daemon start` | Start beads daemon |
 | `genie daemon stop` | Stop beads daemon |
 | `genie daemon status` | Show daemon status |

docs/agent-profiles.md

@@ -1,6 +1,6 @@
-# Worker Profiles
+# Agent Profiles
 
-Worker profiles configure how genie-cli spawns Claude Code workers. Each profile bundles:
+Agent profiles configure how genie-cli spawns Claude Code agents. Each profile bundles:
 - **Launcher**: `claude` (direct Claude Code invocation)
 - **Claude Args**: CLI arguments passed to Claude Code
 
@@ -47,10 +47,10 @@ genie profiles default coding-fast
 
 ## Using Profiles
 
-### With genie worker spawn
+### With genie agent spawn
 ```bash
-genie worker spawn --role implementor --profile coding-fast
-genie worker spawn --role implementor --profile safe  # For interactive work
+genie agent spawn --role implementor --profile coding-fast
+genie agent spawn --role implementor --profile safe  # For interactive work
 ```
 
 ### With genie work

openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "genie",
   "name": "Genie",
   "description": "Skills, agents, and hooks for the Genie CLI terminal orchestration toolkit",
-  "version": "3.260302.2",
+  "version": "3.260309.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/genie",
-  "version": "3.260302.2",
+  "version": "3.260309.1",
   "description": "Collaborative terminal toolkit for human + AI workflows",
   "type": "module",
   "bin": {

plugins/genie/.claude-plugin/plugin.json

@@ -1,11 +1,15 @@
 {
-  "name": "genie",
-  "version": "3.260302.2",
+  "name": "automagik-genie",
+  "version": "3.260309.1",
   "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, turn them into wishes, execute with /work, validate with /review, and ship as one team.",
   "author": {
     "name": "Namastex Labs"
   },
   "repository": "https://github.com/automagik-dev/genie",
   "license": "MIT",
-  "keywords": ["workflow", "orchestration", "collaboration", "claude-code", "tmux", "agents"]
+  "keywords": ["workflow", "orchestration", "collaboration", "claude-code", "tmux", "agents"],
+  "skills": "./skills",
+  "hooks": "./hooks/hooks.json",
+  "agents": "./agents",
+  "settings": "./settings.json"
 }

plugins/genie/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Genie CLI hooks - setup, wish validation, session context, and completion awareness",
+  "description": "Genie plugin hooks — setup, onboarding, dispatch, wish validation, and completion awareness",
   "hooks": {
     "SessionStart": [
       {
@@ -10,6 +10,11 @@
             "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/smart-install.js",
             "timeout": 60
           },
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/first-run-check.cjs",
+            "timeout": 5
+          },
           {
             "type": "command",
             "command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/session-context.cjs",
@@ -19,6 +24,16 @@
       }
     ],
     "PreToolUse": [
+      {
+        "matcher": "SendMessage",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "genie hook dispatch",
+            "timeout": 15
+          }
+        ]
+      },
       {
         "matcher": "Write",
         "hooks": [

plugins/genie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genie-plugin",
-  "version": "3.260302.2",
+  "version": "3.260309.1",
   "private": true,
   "description": "Runtime dependencies for genie bundled CLIs",
   "type": "module",

plugins/genie/references/dispatch-contract.md

@@ -64,20 +64,20 @@ Documented for future validation. Three-layer chain: OpenClaw → genie → Clau
 
 ```bash
 # Spawn a Claude Code worker via genie
-genie worker spawn --role implementor
+genie agent spawn --role implementor
 
 # Or for heavy multi-file work with bead tracking
 bd create "<task title>" --type task
 genie work <bead-id>
 
 # Monitor
-genie worker list
-genie worker read <worker>
+genie agent list
+genie agent read <agent>
 ```
 
 - **Isolation:** Claude Code worktrees (same as CC path, initiated via genie)
 - **Model:** sonnet (passed to CC via genie)
-- **Coordination:** genie worker status + bead updates
+- **Coordination:** genie agent status + bead updates
 - **Risk:** 3 layers of indirection — use timeouts, fall back to sequential on failure
 
 ## Rules