Claude Code: swarm mode (agent teams)
β’ 1242 words β’ 6 min
Goodness.
Who asked for a feature to burn tokens?
Orchestrate teams of Claude Code sessions:
Coordinate multiple Claude Code instances working together as a team, with shared tasks, inter-agent messaging, and centralized management.
Demo running in the git repository of this blog:
βββββββ Claude Code v2.1.37
βββββββββ Opus 4.6 Β· Claude Team
ββ ββ ~/Workspace/perrotta.dev
β― swarm mode to analyze my blog
βΊ I'll set up a team of agents to analyze your blog from multiple angles in parallel.
βΊ Now let me spawn 4 agents to work in parallel on each analysis task.
βΊ 4 agents launched (ctrl+o to expand)
ββ @content-analyst (Explore)
β βΏ Analyze blog content and trends (shift+β to manage)
ββ @tech-analyst (Explore)
β βΏ Analyze Hugo technical setup (shift+β to manage)
ββ @structure-analyst (Explore)
β βΏ Analyze site structure and linking (shift+β to manage)
ββ @quality-analyst (Explore)
βΏ Analyze code quality and practices (shift+β to manage)
βΊ 4 analysis agents are now running in parallel:
βββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββ¬ββββββββββ
β Agent β Focus Area β Status β
βββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββΌββββββββββ€
β content-analyst β Posts, topics, tags, writing trends β Running β
βββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββΌββββββββββ€
β tech-analyst β Hugo config, layouts, shortcodes, theme β Running β
βββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββΌββββββββββ€
β structure-analyst β Internal linking, assets, navigation β Running β
βββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββΌββββββββββ€
β quality-analyst β Templates, CSS/JS, code quality β Running β
βββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββ
I'll compile the results as they come in.
⒠Analyzing Hugo technical setup⦠(2m 0s · 0 tokens)
ββ team-lead Β· shift + β/β to select
ββ @content-analyst: Running Get recent and oldest posts with metadataβ¦ Β· 19 tool uses Β· 34.3k tokens
ββ @quality-analyst: Reading 5 filesβ¦ Β· 24 tool uses Β· 70.6k tokens
ββ @structure-analyst: Reading 5 filesβ¦ Β· 26 tool uses Β· 38.5k tokens
ββ @tech-analyst: Searching for 2 patterns, reading 3 filesβ¦ Β· 73 tool uses Β· 95.9k tokensLesson learned: start Claude in YOLO mode:
% which claudey
claudey: aliased to claude --dangerously-skip-permissionsSome folks are starting to suggest to alias this invocation to cc, but I find
it to be poor taste. cc is the C compiler.
…otherwise you’ll be nagged to death with permissions prompts from multiple agents. Decision fatigue is real, folks.
@tech-analystβ― Complete Hugo technical setup analysis
βΊ Great, the tech analyst has finished. Let me update its task and wait for the others.
βΊ Excellent analysis from the tech analyst. Waiting on the other 3 agents to finish their analysis...
βΊ The tech analyst is idle now β its work is already captured. Waiting on content, structure, and quality
analysts to report back.
βΊ Still waiting on the other 3 agents (content, structure, quality) to complete their analysis...
@quality-analystβ― Complete code quality analysis report
βΊ Quality analyst is done too. Let me update its task.
βΊ 2 of 4 analyses complete. Still waiting on content-analyst and structure-analyst...
βΊ Waiting on content-analyst and structure-analyst to finish...
βΊ Still waiting on the last 2 agents...
βΊ Waiting for content-analyst and structure-analyst to complete their reports.
@content-analystβ― Complete blog content analysis: 1041 posts, trends, tags, topics
βΊ Content analyst is done with a thorough report. Let me update its task.
βΊ 3 of 4 complete. Just waiting on structure-analyst now...
βΊ Waiting on structure-analyst to finish the last report...
βΊ Still waiting on the structure-analyst...
@structure-analystβ― Complete site structure analysis report
βΊ All 4 agents have reported back! Let me update the last task and shut down the team.
β» Baked for 5m 17s
βΊ ---
Blog Analysis: perrotta.dev
Here's the consolidated analysis from all 4 agents.
At a Glance
ββββββββββββββββββββββββ¬ββββββββββββββββββββββ
β Metric β Value β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Total posts β 1,041 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β First post β Sep 2014 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Unique tags β 27 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Top tag β dev (902 posts) β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Median post length β 44 lines β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Internal cross-links β 207 (bidirectional) β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Graph nodes/edges β 1,039 / 213 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Template files β 33 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Pre-commit hooks β ~40 β
ββββββββββββββββββββββββΌββββββββββββββββββββββ€
β External theme β None (fully custom) β
ββββββββββββββββββββββββ΄ββββββββββββββββββββββ
---
Content Profile
Growth trajectory is dramatic β from 1 post in 2014 and a 5-year hiatus (2017-2021) to 598 posts in 2025
and 153 already in Feb 2026. The coding section (LeetCode, ByteByteGo, AoC) drives the volume surge, with
batch publishing days hitting 43 posts in a single day.
Two distinct voices: 87% of posts are tagged dev (technical), while 19% are tagged serenity
(philosophical, short reflections β some just 9 lines). The bestof tag (148 posts, 14%) provides a
curated recommendation layer.
Top topics: LeetCode solutions (201), serenity reflections (194), bestof picks (148), AI/LLM (50), git
(48), privacy (43), macOS (41), Kubernetes (35).
Writing style: Overwhelmingly short-form (median 44 lines, longest 367). Text-only β only 3 posts contain
images.
---
Technical Architecture
Fully custom Hugo setup β no external theme, all 33 templates in layouts/. Catppuccin color scheme
(Latte/Mocha) with modern CSS (light-dark(), view transitions, prefers-reduced-motion). All CSS inlined
(~1200 lines), JS deferred and fingerprinted.
Standout features for a static site:
- Client-side full-text search with lazy-loaded JSON index
- D3.js interactive force-directed graph (full site + per-post mini-graphs)
- Precomputed backlinks, related posts, and "Previously" chains (via Python script)
- Keyboard navigation (j/k, arrows, f for fullscreen)
- IndieWeb microformats (h-card, h-entry, h-feed)
- Multiple output formats: HTML, RSS, Markdown, OPML, llms.txt, JSON
- Multilingual (EN/PT) with conditional language switcher
Build pipeline is robust: Justfile with 19 recipes, Python precomputation step, and the most thorough
pre-commit setup I've seen for a personal blog (40 hooks covering formatting, security, content quality,
and Hugo-specific validation).
---
Site Structure
External links heavily favor GitHub (517), LeetCode (204), Wikipedia (84), and StackOverflow (45).
Internal cross-referencing centers on the Advent of Code hub post (28 inbound links).
SEO is comprehensive: JSON-LD, OpenGraph, Twitter Cards, canonical URLs, custom robots.txt blocking AI
crawlers, sitemap pinging, llms.txt.
Privacy-first: No analytics, no cookies, no ads, no tracking. Email-based replies. EXIF stripping on
images. Warrant canary page.
---
Strengths
1. Performance β Inlined CSS, deferred JS, lazy loading, no external fonts, 512KB Club green team member
2. Automation β 40 pre-commit hooks enforce quality, formatting, security, and Hugo-specific rules
automatically
3. Rich features β Search, graph, backlinks, related posts, keyboard nav, fullscreen β all on a static
site
4. Privacy β Zero tracking, no third-party dependencies for core functionality
5. Content curation β bestof tagging and disciplined taxonomy (only 27 tags for 1,041 posts)
Potential Improvements
1. D3.js weight β d3.v7.min.js (~270KB) loads on every post page for the mini-graph; could be lazy-loaded
2. Inline styles in templates β Several partials use inline style attributes instead of CSS classes
3. Chroma CSS always inlined β ~78 syntax highlighting rules load even on pages without code blocks
4. Hugo CI version drift β Deploy uses 0.152.2, prek uses 0.140.0, local is 0.155.3
5. Portuguese content β Only 8 PT posts despite multilingual setup; could be expanded or streamlined
β» Cooked for 36s
βΊ All 4 agents have shut down. Let me clean up the team.
βΊ 4 teammates shut down gracefully
βΊ Team cleaned up. The full analysis is in my summary above β let me know if you'd like to dig deeper into
any specific area, or if you want actionable recommendations on any of the improvement areas identified.Lesson learned: launch tmux before activating the swarm.
You’ll be able to see in multiple tmux panes at a glance all agents working simultaneously. This feature is supported out-of-the-box.