@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/commands/automation/session-memory.md

@@ -1,3 +1,7 @@
+---
+name: automation:session-memory
+---
+
 # Cross-Session Memory
 
 ## Purpose
@@ -15,22 +19,21 @@ At session end, automatically saves:
 
 ### 2. Session Restoration
 ```javascript
-// Using MCP tools for memory operations
-mcp__monomind__memory_usage({
-  "action": "retrieve",
-  "key": "session-state",
-  "namespace": "sessions"
+// Retrieve saved session state
+mcp__monomind__memory_retrieve({
+  key: "session-state",
+  namespace: "sessions"
 })
 
-// Restore swarm state
-mcp__monomind__context_restore({
-  "snapshotId": "sess-123"
+// Restore a named session
+mcp__monomind__session_restore({
+  sessionId: "sess-123"
 })
 ```
 
 **Fallback with npx:**
 ```bash
-npx monomind hook session-restore --session-id "sess-123"
+npx monomind hooks session-restore --id "sess-123"
 ```
 
 ### 3. Memory Types
@@ -55,36 +58,32 @@ npx monomind hook session-restore --session-id "sess-123"
 
 ### 4. Privacy & Control
 ```javascript
-// List memory contents
-mcp__monomind__memory_usage({
-  "action": "list",
-  "namespace": "sessions"
+// List memory entries by namespace
+mcp__monomind__memory_list({
+  namespace: "sessions"
 })
 
-// Delete specific memory
-mcp__monomind__memory_usage({
-  "action": "delete",
-  "key": "session-123",
-  "namespace": "sessions"
+// Delete specific memory entry
+mcp__monomind__memory_delete({
+  key: "session-123",
+  namespace: "sessions"
 })
 
-// Backup memory
-mcp__monomind__memory_backup({
-  "path": "./backups/memory-backup.json"
-})
+// Check memory stats
+mcp__monomind__memory_stats({})
 ```
 
 **Manual control:**
 ```bash
-# View stored memory
-ls .monomind/memory/
+# List saved sessions
+npx monomind session list
 
-# Disable memory
+# Disable memory persistence
 export MONOMIND_MEMORY_PERSIST=false
 ```
 
 ## Benefits
-- 🧠 Contextual awareness
-- 📈 Cumulative learning
-- ⚡ Faster task completion
-- 🎯 Personalized optimization
+- Contextual awareness
+- Cumulative learning
+- Faster task completion
+- Personalized optimization

package/.claude/commands/automation/smart-agents.md

@@ -1,3 +1,7 @@
+---
+name: automation:smart-agents
+---
+
 # Smart Agent Auto-Spawning
 
 ## Purpose
@@ -31,12 +35,16 @@ The system monitors workload and spawns additional agents when:
 ```javascript
 // Check swarm health
 mcp__monomind__swarm_status({
-  "swarmId": "current"
+  swarmId: "current"
 })
 
-// Monitor agent performance
-mcp__monomind__agent_metrics({
-  "agentId": "agent-123"
+// Monitor agent status and health
+mcp__monomind__agent_status({
+  id: "agent-123"
+})
+mcp__monomind__agent_health({
+  id: "agent-123",
+  detailed: true
 })
 ```
 
@@ -63,11 +71,11 @@ mcp__monomind__agent_spawn({
 ### Fallback Configuration
 If MCP tools are unavailable:
 ```bash
-npx monomind hook pre-task --auto-spawn-agents
+npx monomind hooks pre-task --description "<task>" --auto-spawn
 ```
 
 ## Benefits
-- 🤖 Zero manual agent management
-- 🎯 Perfect agent selection
-- 📈 Dynamic scaling
-- 💾 Resource efficiency
+- Zero manual agent management
+- Perfect agent selection
+- Dynamic scaling
+- Resource efficiency

package/.claude/commands/automation/smart-spawn.md

@@ -1,25 +1,66 @@
+---
+name: automation:smart-spawn
+---
+
 # smart-spawn
 
-Intelligently spawn agents based on workload analysis.
+Automatically spawn agents at the start of a task using the hooks pre-task system.
 
 ## Usage
+
 ```bash
-npx monomind automation smart-spawn [options]
+npx monomind hooks pre-task --description "<task>" --auto-spawn
 ```
 
 ## Options
-- `--analyze` - Analyze before spawning
-- `--threshold <n>` - Spawn threshold
-- `--topology <type>` - Preferred topology
+
+- `--description, -d <text>` - Task description (used for agent selection)
+- `--auto-spawn` - Enable automatic agent spawning based on task analysis
+- `--id, -i <id>` - Task ID
 
 ## Examples
+
+### Auto-spawn agents for a task
+
+```bash
+npx monomind hooks pre-task --description "Implement OAuth with Google" --auto-spawn
+```
+
+### Route + spawn in one step
+
 ```bash
-# Smart spawn with analysis
-npx monomind automation smart-spawn --analyze
+npx monomind hooks route --task "Build REST API" --include-explanation
+npx monomind hooks pre-task --description "Build REST API" --auto-spawn
+```
+
+## How It Works
+
+The `pre-task` hook analyzes the task description and automatically selects and spawns the right agents:
 
-# Set spawn threshold
-npx monomind automation smart-spawn --threshold 5
+- **Simple tasks** (`Fix typo`) → single coordinator agent
+- **Complex tasks** (`Implement OAuth`) → Architect + Coder + Tester + Researcher
+- **Parallel tasks** → mesh topology with load-balanced workers
 
-# Force topology
-npx monomind automation smart-spawn --topology hierarchical
+## Integration with Claude Code
+
+```javascript
+// Initialize swarm with auto strategy
+mcp__monomind__swarm_init({
+  topology: "hierarchical",
+  maxAgents: 8,
+  strategy: "specialized"
+})
+
+// Then spawn the appropriate agent type
+mcp__monomind__agent_spawn({
+  type: "coder",
+  name: "Task Handler",
+  capabilities: ["typescript", "api"]
+})
 ```
+
+## See Also
+
+- `auto-agent` — spawn agents manually with explicit type/task
+- `workflow-select` — run a predefined workflow template
+- `hooks pre-task` — full pre-task hook reference

package/.claude/commands/automation/workflow-select.md

@@ -1,25 +1,60 @@
+---
+name: automation:workflow-select
+---
+
 # workflow-select
 
-Automatically select optimal workflow based on task type.
+Run a predefined workflow template for common tasks.
 
 ## Usage
+
 ```bash
-npx monomind automation workflow-select [options]
+npx monomind workflow run [options]
 ```
 
 ## Options
-- `--task <description>` - Task description
-- `--constraints <list>` - Workflow constraints
-- `--preview` - Preview without executing
+
+- `--template, -t <name>` - Workflow template name
+- `--task <description>` - Task description (for template selection)
+- `--parallel` - Enable parallel agent execution
+- `--max-agents <n>` - Max agents to spawn (default: 4)
+- `--dry-run` - Preview workflow without executing
 
 ## Examples
+
+### List available templates
+
 ```bash
-# Select workflow for task
-npx monomind automation workflow-select --task "Deploy to production"
+npx monomind workflow template list
+```
 
-# With constraints
-npx monomind automation workflow-select --constraints "no-downtime,rollback"
+### Run a template
 
-# Preview mode
-npx monomind automation workflow-select --task "Database migration" --preview
+```bash
+npx monomind workflow run --template feature-development --task "Add OAuth login"
+```
+
+### Preview without executing
+
+```bash
+npx monomind workflow run --template deploy --dry-run
 ```
+
+### Run in parallel
+
+```bash
+npx monomind workflow run --template code-review --parallel --max-agents 6
+```
+
+## Workflow Status
+
+```bash
+npx monomind workflow list
+npx monomind workflow status --watch
+```
+
+## See Also
+
+- `auto-agent` — spawn agents without a template
+- `smart-spawn` — auto-select agents from task description
+- `swarm init` — manual swarm initialization

package/.claude/commands/browse.md

@@ -1,3 +1,8 @@
+---
+name: browse
+description: Launch agent-browser for web UI testing and automation — installs if missing, then runs the agent-browser-testing skill
+---
+
 Invoke the agent-browser-testing skill to test or automate a web UI.
 
 Run this shell command immediately without asking for confirmation:

package/.claude/commands/coordination/README.md

@@ -1,9 +1,13 @@
+---
+name: coordination:readme
+---
+
 # Coordination Commands
 
-Commands for coordination operations in Monomind.
+Commands and guidance for swarm coordination and task orchestration in Monomind.
 
-## Available Commands
+## Commands (invoke as slash commands)
 
-- [swarm-init](./swarm-init.md)
-- [agent-spawn](./agent-spawn.md)
-- [task-orchestrate](./task-orchestrate.md)
+- [swarm-init](./swarm-init.md) — initialize a swarm with topology and strategy (`monomind swarm init`)
+- [agent-spawn](./agent-spawn.md) — spawn a new agent in the swarm (`monomind agent spawn`)
+- [task-orchestrate](./task-orchestrate.md) — coordinate tasks across swarm agents (`monomind swarm coordinate`)

package/.claude/commands/coordination/agent-spawn.md

@@ -1,25 +1,69 @@
+---
+name: coordination:agent-spawn
+---
+
 # agent-spawn
 
 Spawn a new agent in the current swarm.
 
 ## Usage
+
 ```bash
 npx monomind agent spawn [options]
 ```
 
 ## Options
-- `--type <type>` - Agent type (coder, researcher, analyst, tester, coordinator)
-- `--name <name>` - Custom agent name
-- `--skills <list>` - Specific skills (comma-separated)
+
+- `--type, -t <type>` - Agent type: `coder`, `researcher`, `analyst`, `tester`, `coordinator`, `architect`
+- `--name, -n <name>` - Custom agent name/identifier
+- `--task <description>` - Initial task for the agent
+- `--provider <name>` - Provider: `anthropic`, `openrouter`, `ollama`
+- `--model <id>` - Specific model to use
+- `--timeout <seconds>` - Agent timeout in seconds
+- `--auto-tools` - Enable automatic tool selection
 
 ## Examples
+
 ```bash
-# Spawn coder agent
-npx monomind agent spawn --type coder
+# Spawn a coder agent
+npx monomind agent spawn --type coder --name bot-1
 
-# With custom name
-npx monomind agent spawn --type researcher --name "API Expert"
+# Spawn researcher with an initial task
+npx monomind agent spawn --type researcher --task "Research React 19 concurrent features"
 
-# With specific skills
-npx monomind agent spawn --type coder --skills "python,fastapi,testing"
+# Spawn with specific provider and model
+npx monomind agent spawn --type architect --provider anthropic --model claude-sonnet-4-6
+
+# Spawn with auto tools and timeout
+npx monomind agent spawn --type coder --auto-tools --timeout 300
 ```
+
+## Agent Types
+
+| Type | Best For |
+|------|----------|
+| `coder` | Implementation, code generation |
+| `researcher` | Documentation, exploration, analysis |
+| `analyst` | Data-driven decisions, performance review |
+| `tester` | Test creation, quality assurance |
+| `coordinator` | Task management, progress tracking |
+| `architect` | System design, architecture decisions |
+
+## Integration with Claude Code
+
+```javascript
+mcp__monomind__agent_spawn({
+  type: "coder",
+  name: "API Builder",
+  capabilities: ["typescript", "rest-api"]
+})
+```
+
+> Note: This tool provides coordination and metadata — Claude Code performs all actual implementation using its native tools.
+
+## See Also
+
+- `swarm-init` — initialize the swarm before spawning agents
+- `agent list` — list all active agents (`monomind agent list`)
+- `agent status` — check agent status (`monomind agent status --id <id>`)
+- `task-orchestrate` — coordinate tasks across spawned agents

package/.claude/commands/coordination/swarm-init.md

@@ -1,4 +1,8 @@
-# swarm init
+---
+name: coordination:swarm-init
+---
+
+# swarm-init
 
 Initialize a Monomind swarm with specified topology and configuration.
 
@@ -10,76 +14,69 @@ npx monomind swarm init [options]
 
 ## Options
 
-- `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
-- `--max-agents, -m <number>` - Maximum number of agents (default: 8)
-- `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
-- `--auto-spawn` - Automatically spawn agents based on task complexity
-- `--memory` - Enable cross-session memory persistence
-- `--github` - Enable GitHub integration features
+- `--topology, -t <type>` - Swarm topology (default: `hierarchical`)
+- `--max-agents, -m <n>` - Maximum number of agents (default: `8`)
+- `--strategy, -s <type>` - Coordination strategy: `balanced`, `parallel`, `sequential`, `specialized`
+- `--auto-scale` - Enable automatic agent scaling
+- `--v1-mode` - Enable v1 15-agent hierarchical mesh mode
 
 ## Examples
 
-### Basic initialization
+### Default hierarchical swarm
 
 ```bash
 npx monomind swarm init
 ```
 
-### Mesh topology for research
+### Mesh topology for research tasks
 
 ```bash
 npx monomind swarm init --topology mesh --max-agents 5 --strategy balanced
 ```
 
-### Hierarchical for development
+### Specialized development swarm
 
 ```bash
-npx monomind swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
+npx monomind swarm init --topology hierarchical --max-agents 8 --strategy specialized
 ```
 
-### GitHub-focused swarm
+### Auto-scaling adaptive swarm
 
 ```bash
-npx monomind swarm init --topology star --github --memory
+npx monomind swarm init --topology adaptive --auto-scale
 ```
 
-## Topologies
-
-### Mesh
-
-- All agents connect to all others
-- Best for: Research, exploration, brainstorming
-- Communication: High overhead, maximum information sharing
-
-### Hierarchical
-
-- Tree structure with clear command chain
-- Best for: Development, structured tasks, large projects
-- Communication: Efficient, clear responsibilities
+### v1 high-performance mode (15 agents)
 
-### Ring
-
-- Agents connect in a circle
-- Best for: Pipeline processing, sequential workflows
-- Communication: Low overhead, ordered processing
+```bash
+npx monomind swarm init --v1-mode
+```
 
-### Star
+## Topologies
 
-- Central coordinator with satellite agents
-- Best for: Simple tasks, centralized control
-- Communication: Minimal overhead, clear coordination
+| Topology | Best For | Communication |
+|----------|----------|---------------|
+| `hierarchical` | Development, structured tasks, large projects | Efficient, clear chain of command |
+| `hierarchical-mesh` | Complex cross-domain work (recommended default) | Balanced overhead + information sharing |
+| `mesh` | Research, exploration, brainstorming | High information sharing |
+| `ring` | Pipeline processing, sequential workflows | Low overhead, ordered |
+| `star` | Centralized control, simple tasks | Minimal overhead |
+| `adaptive` | Unknown complexity, dynamic workloads | Self-adjusting |
+| `hybrid` | Mixed-mode tasks | Configurable |
 
 ## Integration with Claude Code
 
-Once initialized, use MCP tools in Claude Code:
-
 ```javascript
-mcp__monomind__swarm_init { topology: "hierarchical", maxAgents: 8 }
+mcp__monomind__swarm_init({
+  topology: "hierarchical",
+  maxAgents: 8,
+  strategy: "specialized"
+})
 ```
 
 ## See Also
 
-- `agent spawn` - Create swarm agents
-- `task orchestrate` - Coordinate task execution
-- `swarm status` - Check swarm state
-- `swarm monitor` - Real-time monitoring
+- `agent-spawn` — create agents within the swarm
+- `swarm status` — check swarm state (`monomind swarm status`)
+- `swarm start` — start execution (`monomind swarm start --objective "..."`)
+- `task-orchestrate` — coordinate tasks across agents

package/.claude/commands/coordination/task-orchestrate.md

@@ -1,25 +1,79 @@
+---
+name: coordination:task-orchestrate
+---
+
 # task-orchestrate
 
-Orchestrate complex tasks across the swarm.
+Coordinate tasks across a swarm of agents.
 
 ## Usage
+
 ```bash
-npx monomind task orchestrate [options]
+npx monomind swarm coordinate [options]
 ```
 
 ## Options
-- `--task <description>` - Task description
-- `--strategy <type>` - Orchestration strategy
-- `--priority <level>` - Task priority (low, medium, high, critical)
+
+- `--task <description>` - Task to distribute across agents
+- `--agents <list>` - Comma-separated agent IDs or types
+- `--strategy <type>` - Coordination strategy: `parallel`, `sequential`, `pipeline`, `broadcast`
+- `--timeout <seconds>` - Max time to wait for completion
 
 ## Examples
+
+### Coordinate in parallel (default)
+
+```bash
+npx monomind swarm coordinate --task "Run all tests" --strategy parallel
+```
+
+### Sequential pipeline
+
 ```bash
-# Orchestrate development task
-npx monomind task orchestrate --task "Implement user authentication"
+npx monomind swarm coordinate --task "Build, test, and deploy" --strategy pipeline
+```
 
-# High priority task
-npx monomind task orchestrate --task "Fix production bug" --priority critical
+### Broadcast to all agents
 
-# With specific strategy
-npx monomind task orchestrate --task "Refactor codebase" --strategy parallel
+```bash
+npx monomind swarm coordinate --task "Update shared context" --strategy broadcast
 ```
+
+## Task Lifecycle (separate from orchestration)
+
+Use `monomind task` subcommands for individual task management:
+
+```bash
+npx monomind task create --title "Fix auth bug" --priority high
+npx monomind task list --status pending
+npx monomind task status --id <task-id>
+npx monomind task assign --id <task-id> --agent <agent-id>
+npx monomind task cancel --id <task-id>
+npx monomind task retry --id <task-id>
+```
+
+## Strategies
+
+| Strategy | Description |
+|----------|-------------|
+| `parallel` | All agents work simultaneously (default) |
+| `sequential` | Agents execute one after another |
+| `pipeline` | Output of one agent feeds the next |
+| `broadcast` | Same task sent to all agents |
+
+## Integration with Claude Code
+
+```javascript
+mcp__monomind__coordination_orchestrate({
+  task: "Implement user authentication",
+  agents: ["architect", "coder", "tester"],
+  strategy: "sequential",
+  timeout: 300
+})
+```
+
+## See Also
+
+- `swarm-init` — initialize the swarm before orchestrating
+- `agent-spawn` — create agents to orchestrate tasks across
+- `swarm status` — check current swarm state (`monomind swarm status`)

package/.claude/commands/github/README.md

@@ -1,11 +1,24 @@
-# Github Commands
+---
+name: github:README
+---
 
-Commands for github operations in Monomind.
+# GitHub Commands
 
-## Available Commands
+Commands and guidance for GitHub workflow automation in Monomind. All GitHub operations use the `gh` CLI and real monomind MCP tools — there is no `monomind github` CLI command group.
 
-- [github-swarm](./github-swarm.md)
-- [repo-analyze](./repo-analyze.md)
-- [pr-enhance](./pr-enhance.md)
-- [issue-triage](./issue-triage.md)
-- [code-review](./code-review.md)
+## Commands (invoke as slash commands)
+
+- [github-modes](./github-modes.md) — overview of all GitHub workflow modes and swarm integration patterns
+- [issue-tracker](./issue-tracker.md) — issue management and project coordination with swarm agents
+- [pr-manager](./pr-manager.md) — pull request lifecycle management with multi-agent review coordination
+- [release-manager](./release-manager.md) — release preparation, versioning, and deployment pipeline coordination
+- [repo-architect](./repo-architect.md) — repository structure optimization and template management
+- [sync-coordinator](./sync-coordinator.md) — multi-package version alignment and cross-repo synchronization
+
+## Real Tools Used
+
+- `gh` CLI — all GitHub operations (issues, PRs, releases, repos, branches)
+- `mcp__monomind__swarm_init` / `agent_spawn` — swarm coordination
+- `mcp__monomind__coordination_orchestrate` — task coordination across agents (`strategy: parallel|sequential|pipeline|broadcast`)
+- `mcp__monomind__memory_store` / `memory_retrieve` — cross-agent state persistence
+- `gh` CLI — preferred for all direct GitHub API operations not covered by the above