squads-cli 0.4.9 → 0.4.11

package/README.md

@@ -285,6 +285,36 @@ squads memory show engineering
 squads memory query "performance"
 ```
 
+### Learning Loop
+
+Capture insights that persist across sessions:
+
+```bash
+# After fixing a bug
+squads learn "PostgreSQL connection pool exhaustion was caused by unclosed transactions"
+
+# With metadata
+squads learn "Always check memory before researching" --squad engineering --category pattern
+
+# View learnings
+squads learnings show engineering
+squads learnings search "postgres"
+```
+
+Learnings are stored in `.agents/memory/<squad>/shared/learnings.md` and sync with `squads memory sync`.
+
+**Categories:**
+- `success` — What worked well
+- `failure` — What didn't work (learn from mistakes)
+- `pattern` — Reusable approach
+- `tip` — General advice
+
+**The learning loop:**
+1. Session starts → hooks inject squad status + memory
+2. Work happens → you solve problems, discover things
+3. Session ends → Stop hook prompts "Capture learnings: squads learn..."
+4. Next session → Previous learnings compound via memory queries
+
 ### Goals with Metrics
 
 Goals can include optional metric annotations for tracking KPIs:
@@ -436,6 +466,19 @@ squads feedback show research -n 10                   # Show more entries
 squads feedback stats                                 # Summary across all squads
 ```
 
+### Learnings
+
+```bash
+squads learn "Insight here"                           # Capture a learning
+squads learn "Pattern" -s engineering -c pattern      # With squad and category
+squads learn "Tip" -t "cli,perf"                      # With tags
+squads learnings show engineering                     # View squad learnings
+squads learnings show engineering -n 5                # Limit results
+squads learnings show engineering --category pattern  # Filter by category
+squads learnings show engineering --tag perf          # Filter by tag
+squads learnings search "postgres"                    # Search all learnings
+```
+
 ### Session Management
 
 ```bash
@@ -729,6 +772,18 @@ squads feedback show <squad>         View history
   -n, --limit <n>                    Entries to show (default: 5)
 squads feedback stats                Summary across squads
 
+squads learn <insight>               Capture a learning
+  -s, --squad <squad>                Associate with squad (default: general)
+  -c, --category <category>          Category: success, failure, pattern, tip
+  -t, --tags <tags>                  Comma-separated tags
+  --context <context>                Additional context
+squads learnings show <squad>        View squad learnings
+  -n, --limit <n>                    Entries to show (default: 10)
+  --category <category>              Filter by category
+  --tag <tag>                        Filter by tag
+squads learnings search <query>      Search all learnings
+  -n, --limit <n>                    Results to show (default: 10)
+
 squads sessions                      List active sessions
   -v, --verbose                      Session details
   -j, --json                         JSON output
@@ -765,6 +820,44 @@ squads workers                       Show active workers
   -v, --verbose                      More details
   -k, --kill <pid>                   Kill process
 
+squads context                       Business context for alignment
+  -s, --squad <squad>                Focus on specific squad
+  -t, --topic <topic>                Search memory for relevant context
+  -v, --verbose                      Show additional details
+  --json                             JSON output
+
+squads history                       Recent agent execution history
+  -d, --days <n>                     Days to look back (default: 7)
+  -s, --squad <squad>                Filter by squad
+  -v, --verbose                      Show cost and token details
+  -j, --json                         JSON output
+
+squads health                        Quick infrastructure health check
+  -v, --verbose                      Show logs for failures
+  --json                             JSON output
+
+squads watch <command> [args]        Live refresh any command (like Unix watch)
+  -n, --interval <seconds>           Refresh interval (default: 2)
+
+squads live                          Live TUI dashboard (like htop)
+  -r, --refresh <ms>                 Refresh rate (default: 1000)
+
+squads top                           Live process table (like Unix top)
+
+squads version                       Show version information
+
+squads env show <squad>              Squad execution environment (MCP, model, budget)
+  --json                             JSON output
+squads env list                      List all squad environments
+  --json                             JSON output
+
+squads cost                          Cost summary (today, week, by squad)
+  -s, --squad <squad>                Filter to specific squad
+  --json                             JSON output
+
+squads budget <squad>                Check budget status for a squad
+  --json                             JSON output
+
 squads issues                        GitHub issues
   -o, --org <org>                    Organization (default: agents-squads)
   -r, --repos <repos>                Comma-separated repos
@@ -831,7 +924,7 @@ squads whoami                        Show user
 
 ## Claude Code Integration
 
-### Option 1: Session Hook (Recommended)
+### Option 1: Session Hooks (Recommended)
 
 Add to `.claude/settings.json`:
 
@@ -844,12 +937,21 @@ Add to `.claude/settings.json`:
         "command": "squads status",
         "timeout": 10
       }]
+    }],
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "squads memory sync && echo \"\\n💡 Capture learnings: squads learn \\\"<insight>\\\"\\n\"",
+        "timeout": 15
+      }]
     }]
   }
 }
 ```
 
-Now every Claude Code session starts with squad context.
+Now every Claude Code session:
+- **Starts** with squad status injected
+- **Ends** with memory synced and a prompt to capture learnings
 
 ### Option 2: CLAUDE.md Instructions