Fix readme link to swarm-tools #3
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Update AGENTS.md to prioritize swarm plugin tools over raw CLI - Deprecate bd CLI and bd-quick tools in favor of beads_* plugin tools - Add swarm workflow section with learning integration details - Update README with npm installation instructions - Add CASS and UBS tool wrappers - Fix semantic-memory to use npx
- Add proper args definition (task, max_subtasks, no_cass, no_ubs, to_main) - Simplify flow to plugin-centric approach - Remove verbose bash examples in favor of tool calls - Add learning section explaining outcome tracking - Reduce from 232 lines to focused ~120 lines
- Use $ARGUMENTS instead of custom args (matches plugin example) - Add swarm_spawn_subtask which generates V2 prompts with Agent Mail/beads - Simplify flow diagram - Remove redundant flags (plugin handles CASS/UBS internally) - Match structure of plugin's examples/commands/swarm.md
- Create agent/swarm-worker.md with Sonnet 4.5 model - Update /swarm command to use swarm-worker subagent type - Update AGENTS.md and README.md agent tables with model column - swarm-worker is pre-configured with Agent Mail/beads patterns Cost optimization: Sonnet for implementation, default for coordination
* feat: add swarm-worker agent (Sonnet 4.5) for parallel tasks - Create agent/swarm-worker.md with Sonnet 4.5 model - Update /swarm command to use swarm-worker subagent type - Update AGENTS.md and README.md agent tables with model column - swarm-worker is pre-configured with Agent Mail/beads patterns Cost optimization: Sonnet for implementation, default for coordination * bd sync: 2025-12-08 09:23:43 * bd sync: 2025-12-08 09:23:56 * feat: add debug-plus command with prevention pipeline - Create knowledge/prevention-patterns.md with 15 error-to-prevention mappings - Create command/debug-plus.md with swarm integration for complex debugging - Update command/debug.md with reference to debug-plus for systemic issues - Update AGENTS.md with debug-plus in commands table and knowledge files Debug-plus turns reactive debugging into proactive codebase improvement by: - Detecting multi-file issues and spawning investigation swarms - Matching errors to prevention patterns automatically - Creating preventive beads for follow-up work - Optionally spawning prevention swarms for codebase-wide fixes
- Add swarm-planner.md agent (Sonnet 4.5) for strategic task decomposition - Update swarm.md command with new strategy selection workflow - Add swarm_select_strategy and swarm_plan_prompt tools to docs - Add swarm_spawn_subtask tool reference - Update agent tables in AGENTS.md and README.md
- Add knowledge files for plugins, agents, tools, context management - Create prioritized IMPROVEMENTS.md with actionable recommendations - Fix pdf-brain tool timeout issues (bunx + proper timeout handling) Key findings: - Doom loop detection needed - Abort signal handling missing in custom tools - Output size limits not enforced - Nested agent directories supported but unused Epic: opencode-pnt
- Add checkDoomLoop() function to track repeated tool calls - Threshold: 3 identical calls triggers detection - History: last 10 calls per session (FIFO) - Comprehensive JSDoc with usage examples - Exported for integration with swarm workflow Closes opencode-acg.1
repo-autopsy.ts: - Add 5-minute cache to skip redundant git fetches - Parallelize hotspots analysis (4 concurrent queries) - Parallelize exports_map analysis (3 concurrent queries) - Parallelize clone stats (file count + languages) - Add refresh flag to force cache bypass - Integrate truncateOutput for large results repo-crawl.ts: - Add GITHUB_TOKEN support for 5000 req/hr (vs 60/hr) - Add abort signal propagation to all fetch calls - Parallelize structure tool (repo info + contents) - Better rate limit error messages - Use truncateOutput consistently tool-utils.ts (new): - truncateOutput() - cap at 30K chars with notice - formatError() - consistent error formatting - withTimeout() - promise timeout wrapper Also includes abort signal handling from Week 1 epic.
- Sort search results newest-first by modification time - Use result.mtime/modified fields with fs.statSync fallback - Graceful error handling preserves original output - Refs: opencode-7f1.2
- Reorganize swarm agents into nested directories (swarm/planner, swarm/worker) - Add mtime sorting to CASS search results (newest first) - Add FileTime tracking infrastructure for beads (recordBeadRead, assertBeadFresh) - Document streaming metadata API limitation and workarounds Epic: opencode-7f1
Stolen from nexxeln/opencode-config (with credit): - /rmslop command to remove AI code slop from branches - notify.ts plugin for audio alerts on completion/errors - git push: ask permission to prevent wrong-branch accidents - Effect-TS patterns: Effect.fn, Schema.Defect, Config.redacted, Layer memoization Also includes: - Updated README with sick ASCII art and current structure - 7 bundled skills (testing, swarm, cli-builder, etc.) - Improved AGENTS.md with tool preferences and workflows - Session compacting hook for swarm state recovery
- Add Kernel cloud browser MCP server with OAuth authentication - Rename beads_* tool references to hive_* across docs - Update README with Kernel setup instructions - Fix terminology: beads → cells, beads → hive where appropriate - Add .opencode/ to gitignore (internal postgres db)
- New OPENCODE CONFIG banner at top - SWARM banner in swarmtools section - Learning Pipeline diagram (CASS → Decompose → Execute → Record) - Coordinator vs Worker architecture diagram - Highlight joelhooks/swarmtools as core innovation - Lead with learning system (confidence decay, anti-pattern inversion) - CASS cross-agent search, semantic memory - 70% cost reduction via coordinator-worker split - Scale metrics: 57 swarm tools, 12 custom tools, 6 MCP servers - Debug-to-prevention pipeline flow - Portfolio-quality presentation for GitHub
- Add config inventory to IMPROVEMENTS.md (from swarm audit) - Update swarm plugin wrapper - Remove notify.ts (consolidated) - Update skills bundled JSON - Sync agent/command docs
- Add TDD COMMANDMENT section to AGENTS.md (RED→GREEN→REFACTOR) - Update swarm/worker.md checklist with TDD steps (5-7) - Create knowledge/tdd-patterns.md with full doctrine - Reference Feathers (seams, characterization tests) and Beck (red-green-refactor) - Link to testing-patterns skill for 25 dependency-breaking techniques - Point to pdf-brain for source material deep dives
- Add 'Overspecified Tests (THE WORST)' as first anti-pattern - Include Tornhill quote on excess mocking - Add concrete examples of overspecified vs behavior-focused tests - Add 'What Good Tests Look Like' section - Include 'Refactor Test' heuristic - Mock boundaries not internals guidance - Test names as documentation examples
- Add 'One Assertion Per Test' section with Fowler quote - Show before/after examples of multi-assert vs focused tests - Add 'Arrange-Act-Assert (Given-When-Then)' structure - Add 'Test Names as Executable Specifications' with Feathers quote - Include BDD-style naming examples - Add pdf-brain query hints for deeper lore dives
- Add 'tags' param to store (comma-separated categorization) - Add 'expand' param to find (full content vs truncated preview) - Add 'get' tool (retrieve specific memory by ID) - Add 'remove' tool (delete outdated/incorrect memories) - Add 'migrate' tool (PGlite 0.2.x → 0.3.x migration) - Update AGENTS.md tool table and usage examples
- Expand Prerequisites into full Installation section - Add step-by-step setup for swarm, ollama, semantic-memory, cass - Document current tested versions (swarm 0.30.0, cass 0.1.35, ollama 0.13.1) - Add optional setup for Kernel and Snyk - Include swarm doctor verification step Also includes: - Plugin update to 0.30.0 (better error handling, detection confidence) - Skill bundle version syncs - Package.json plugin version bump
- Move installation/quickstart to top (right after intro) - Consolidate version reference table - Trim redundant sections - Keep detailed explanations below the fold - Remove duplicate content and fluff
- Add callout that CLIs are agent backends, not for human use - Clarify /swarm runs inside OpenCode, not terminal - Update intro to mention OpenCode explicitly
- Add [!IMPORTANT], [!NOTE], [!WARNING], [!TIP] alerts - Add opening quote from Shiffman on emergent group dynamics - Add van Merriënboer quote on feedback loops - Add Feathers quote on legacy code - Add closing Evans quote on patterns as building blocks - Strengthen OpenCode-only messaging with proper callouts
- README now correctly says 'bun install' (matches bun-types in devDeps) - Removed pnpm-lock.yaml to avoid package manager confusion - Plugin version bump from earlier session work
- Add URL support for add command (PDFs and Markdown from URLs) - Add Markdown file support (.md, .markdown) - Add --expand param to search (context expansion up to 4000 chars) - Add repair command (fix orphaned chunks/embeddings) - Add export/import commands (backup/restore library) - Add migrate command (--check, --import, --generate-script) - Update batch_add to handle both PDFs and Markdown - Use direct pdf-brain CLI instead of bunx wrapper
📝 WalkthroughWalkthroughREADME hyperlink and displayed library name changed from "swarmtools" to "swarm-tools" to correct the referenced swarm orchestration library name. Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~2 minutes Poem
Pre-merge checks✅ Passed checks (3 passed)
📜 Recent review detailsConfiguration used: defaults Review profile: CHILL Plan: Pro 📒 Files selected for processing (1)
🚧 Files skipped from review as they are similar to previous changes (1)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
📜 Review details
Configuration used: defaults
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
README.md
🧰 Additional context used
🧠 Learnings (2)
📚 Learning: 2025-12-08T17:30:12.981Z
Learnt from: CR
Repo: joelhooks/opencode-config PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-08T17:30:12.981Z
Learning: Use Swarm plugin tools (beads_*, agentmail_*, swarm_*) for multi-step work instead of raw CLI/MCP commands
Applied to files:
README.md
📚 Learning: 2025-12-08T17:30:12.981Z
Learnt from: CR
Repo: joelhooks/opencode-config PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-12-08T17:30:12.981Z
Learning: Use /swarm command for multi-file changes (3+ files) to enable parallel agent coordination
Applied to files:
README.md
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary by CodeRabbit
✏️ Tip: You can customize this high-level summary in your review settings.