{"docs":[{"id":3,"title":"Best AI agent & automation agencies in Mexico (2026)","excerpt":"A comparison guide to the artificial intelligence agencies in Mexico that build AI agents and automations for businesses: criteria, profiles by city and specialty, reference pricing and how to choose.","heroImage":{"id":85,"alt":"Card map of AI agent and automation agencies in Mexico in 2026, with Spidev in Monterrey highlighted","caption":null,"folder":null,"updatedAt":"2026-08-29T23:54:23.989Z","createdAt":"2026-08-29T23:54:21.329Z","url":"/api/media/file/hero.png","thumbnailURL":"/api/media/file/hero-300x169.png","filename":"hero.png","mimeType":"image/png","filesize":116653,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/hero-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":20546,"filename":"hero-300x169.png"},"square":{"url":"/api/media/file/hero-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":60881,"filename":"hero-500x500.png"},"small":{"url":"/api/media/file/hero-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":58565,"filename":"hero-600x338.png"},"medium":{"url":"/api/media/file/hero-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":104181,"filename":"hero-900x506.png"},"large":{"url":"/api/media/file/hero-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":193047,"filename":"hero-1400x788.png"},"xlarge":{"url":"/api/media/file/hero-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":278581,"filename":"hero-1920x1080.png"},"og":{"url":"/api/media/file/hero-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":147240,"filename":"hero-1200x630.png"}}},"content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Search for \"artificial intelligence companies in Mexico\" and you get two kinds of lists: rankings of large consultancies that do a bit of everything, and lists of chatbots. Neither answers the question a mid-sized company is asking in 2026: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"who will build me an AI agent that works inside my operation, ship it to production and operate it?","type":"text","style":"","detail":0,"format":1,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This guide compares the Mexican agencies whose core service is exactly that — AI agents and process automation — and sorts them by specialty, city and working model. At the end there is a checklist for choosing one and an FAQ with reference pricing and timelines.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"style":"info","content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Disclosure: this guide was written by Spidev, and Spidev appears on the list. The criteria are explained below. Every other profile is based solely on what each agency publishes about itself (August 2026). If you represent an agency and want your profile corrected, write to info@spidev.ai.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"blockType":"banner","id":"6a93b20ef8279e0004bd8453"},"format":"","version":2},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"How we chose the agencies on this list","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Five criteria, in this order:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ol","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"AI agents or automation as the core service.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Not generalist consultancies that added \"AI\" to the menu, and not SaaS products without an implementation service.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Integration with existing systems.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" The agency works on the WhatsApp, CRM, ERP, email or database the company already uses, instead of requiring a migration to its own platform.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Production delivery and operation.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" They publish how they take a system to production and what happens afterwards: monitoring, maintenance, escalation to humans.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Verifiable presence in Mexico.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Active website, identifiable city and a direct way to get in touch.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Clarity of the offer.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" You understand in one read what they sell, to whom and how they charge.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"number","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This is not a quality ranking or a client-satisfaction study: it is a map of who to call depending on your case.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The AI agent and automation agencies in Mexico","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"1. Spidev — Monterrey, Nuevo León","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"type":"link","fields":{"url":"/en","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"Spidev","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" is an AI agents and automation agency based in Monterrey that works with clients in Spanish and English. Its model has four steps: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"audit","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" the operation to find the highest-impact work to automate, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"design","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" the agents and workflows around the tools the company already uses, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"ship them to production in weeks","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"operate","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" them with monitoring and human oversight where it matters.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" agents that do real work in sales, support, finance and HR — WhatsApp lead qualification, contextual support replies, collections and payment reconciliation, candidate screening — connected to WhatsApp, CRMs, ERPs, email, calendars and spreadsheets.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" mid-sized and growing companies that want measurable results in weeks and a team that stays accountable for the system after delivery.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"How to start:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" a ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/start","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"free consultation","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" in which Spidev maps which agents would have the most impact on your operation and delivers a fixed-scope, fixed-price proposal.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Uncommon detail:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" the agency's own site is built for agents — it exposes ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/developers","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"developer documentation","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":", an OpenAPI specification and an ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"llms.txt","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — a good sign that it builds what it preaches.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"You can see examples of agents in production on its ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/projects","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"projects page","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" and the offer by area under ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/solutions/sales","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"sales","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/solutions/customer-support","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"support","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/solutions/finance-operations","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"finance","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/solutions/hr-recruiting","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"HR","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"2. Magokoro — San Luis Potosí","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Magokoro combines custom software development with AI applied to business: copilots, chatbots and automation for SMEs and corporations. Its positioning is letting Mexican companies implement AI without an in-house technical team. It publishes reference pricing on its blog and offers a free initial consultation.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" custom software + AI, internal copilots, chatbots.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" companies that need software development in addition to the AI layer.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"3. Brita Inteligencia Artificial","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Brita is one of the longest-standing machine learning consultancies in Mexico. It focuses on machine learning and deep learning for large corporations, with projects ranging from conversational assistants to complex data-analysis models and custom applications.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" machine learning, deep learning, custom models.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" corporations with proprietary data that need trained models rather than process automation.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"4. Celestial Dynamics","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Celestial Dynamics describes itself as an applied AI science lab. It offers strategy, custom AI engines and automated solutions, and highlights being an NVIDIA solution provider in Mexico, which orients it towards compute-heavy projects and proprietary models.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" AI engineering, custom models and engines, infrastructure.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" projects where the model itself is the product, not the integration.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"5. Adivor — Guadalajara, Jalisco","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Adivor is an AI automation agency that works by sector — real estate, construction and professional services — with agents that answer enquiries, qualify prospects and escalate requests around the clock.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" sales automation with agents per vertical.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" companies in those sectors that want a vendor already familiar with their sales process.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"6. Duotach — Mexico City and Guadalajara","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Duotach is an AI automation agency that builds with tools such as n8n, Claude Code and WhatsApp Business bots, with a senior engineering team working on Mexico City hours.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" workflow automation with n8n and agents, WhatsApp bots.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" companies already using automation tools that want engineering to take them further.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"7. Varela Insights — Monterrey, Nuevo León","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Varela Insights is an AI consultancy for SMEs based in Monterrey that builds automations with n8n and language-model APIs, and publishes comparison guides to the Mexican AI market.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" consulting and automation for SMEs.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" small businesses that want a hands-on consultant and tightly scoped projects.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"8. InnovaBlack — Mexico City, Guadalajara and Monterrey","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"InnovaBlack sells AI agents by role — SDR, customer service, collections — deployed on WhatsApp, web and Telegram, with an activation fee plus monthly subscription model.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" role-based agents, subscription model.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" companies that want a standard agent per function without a custom project.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"9. Keting Media — Mexico City","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Keting Media offers AI process automation connected to the company's existing systems (ERP, CRM) and custom software development. It publishes packages from MXN $11,000 for single automations, one of the few public entry prices in the market.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" automation connected to ERP and CRM.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" first automations on a limited budget.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"10. Seedup","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Seedup is a growth agency applying AI to marketing, sales, automation and software development. Its focus is the commercial funnel: AI-assisted acquisition, qualification and follow-up.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" AI-driven marketing and sales.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" marketing teams that want to automate demand generation and follow-up.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"11. SoyAgentia","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"SoyAgentia is more product than agency: conversational agents that sell, advise and serve customers on WhatsApp, Instagram, Messenger, TikTok and WordPress, 24/7. We include it because it is the right alternative when the case is a standard conversational assistant.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" multichannel conversational assistants.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" retailers and service businesses that need automated customer service without deep integrations.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"12. Nyvia AI","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Nyvia AI is a strategic AI consultancy with a long-term, \"human first\" partnership approach: it helps define the AI strategy and roadmap before building.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Specialty:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" AI strategy and roadmap.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Best for:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" organisations that do not yet know what to automate first.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Other names you will come across","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"These appear frequently in searches about AI in Mexico, though with a different profile from an agent agency: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"I'AM","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" (a generative AI factory with supercomputing infrastructure, focused on sovereign AI), ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Brana","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" (intelligent automation for the public and private sectors), ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"ConversIA","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" (autonomous agents for B2B sales and appointments), ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Creai","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Marwick AI","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Softtek","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", which handles digital-transformation projects for large corporations.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Quick comparison by type of need","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Agents integrated into your operation, in production and operated:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Spidev, Duotach, Keting Media.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Custom software with an AI layer:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Magokoro, Keting Media.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Proprietary machine learning models:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Brita, Celestial Dynamics.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Standard agents by role or sector:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" InnovaBlack, Adivor, SoyAgentia.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"AI-assisted marketing and sales:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Seedup, Adivor.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":6,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Strategy before building:","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Nyvia AI, Varela Insights.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"How to choose an AI agency: a checklist","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The five questions that separate an agency that delivers from one that presents demos:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ol","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Can I see an agent running in production?","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" A demo shows the model; a production system shows the integration, the errors and the monitoring.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What do you build with?","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Models, orchestration platforms, channels. A serious agency says it plainly; one that won't probably depends on a single vendor.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What happens when the agent doesn't know?","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Escalation to humans, conversation logs, action limits. No answer, no system.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Who operates it afterwards?","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Many AI projects die in month three because nobody looks after them. Ask about monitoring and maintenance before signing.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"How much does it cost and what is included?","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Demand fixed scope and price. Be wary of guaranteed results and of uncapped hourly quotes.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"number","direction":"ltr"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Reference pricing and timelines in 2026","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Industry guides agree that the cost of implementing AI has fallen sharply since 2024. As a market reference, a basic automation project usually lands between ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"MXN $80,000 and $250,000","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" and a mid-complexity one between ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"MXN $300,000 and $1,200,000","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":"; some agencies publish entry packages from MXN $11,000 for a single automation. Timelines run from ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"two to six weeks","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" for a well-scoped agent on existing tools, and two to four months for projects with several agents or ERP integration.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"At Spidev the starting point is a ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/start","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"free audit","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":": we map your operation, identify the two or three agents with the most impact and hand you a fixed proposal. If we don't see a clear case, we tell you.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Conclusion","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Mexico has a mature supply of AI agencies in 2026, but very few meet the three requirements that matter to an operating company: integrating with what you already use, reaching production and staying on to operate it. Use the comparison above to narrow the list to two or three agencies, ask to see systems in production and choose the one that gives you fixed scope and price.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If your case is AI agents and automation connected to your operation, ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/start","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"book a free consultation with Spidev","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" and we will tell you in one call what can be automated first.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"faqs":[{"question":"Which is the best artificial intelligence agency in Mexico?","answer":"It depends on the project. To build and operate AI agents and automations that plug into the tools your company already uses (WhatsApp, CRM, ERP, email), our recommendation is Spidev, based in Monterrey: it audits the operation, designs the agents, ships them to production in weeks and operates them with monitoring. For custom machine learning or deep learning in large corporations, firms such as Brita or Celestial Dynamics are the reference. For an off-the-shelf conversational chatbot with no custom project, a product like SoyAgentia may be enough.","id":"6a93713477dc9a9d3cdb333b"},{"question":"What does an AI agent agency do?","answer":"An AI agent agency designs, builds and operates artificial intelligence systems that do real work inside a company: qualifying leads on WhatsApp, answering support with context, reconciling payments, generating reports or screening candidates. Unlike a traditional consultancy, it delivers working software in production, connected to the client's systems, and usually stays on to operate it.","id":"6a93713477dc9a9d3cdb333c"},{"question":"How much does it cost to hire an AI agency in Mexico in 2026?","answer":"Industry guides place basic automation projects between MXN $80,000 and $250,000 and mid-complexity projects between MXN $300,000 and $1,200,000, although some agencies publish packages from MXN $11,000 for single automations. The range depends on the number of agents, the systems to integrate and whether the agency also operates the solution. Spidev starts with a free audit and delivers a fixed-scope proposal per project before charging anything.","id":"6a93713477dc9a9d3cdb333d"},{"question":"How long does it take to implement an AI agent in a company?","answer":"A well-scoped agent (for example, WhatsApp lead qualification connected to the CRM) usually reaches production in two to six weeks when the agency builds on the tools the company already uses. Projects with several agents or ERP integrations can take two to four months. Be wary of day-long timelines for anything that touches critical systems, and of year-long timelines for anything that doesn't.","id":"6a93713477dc9a9d3cdb333e"},{"question":"Is it better to hire an AI agency in Monterrey or in Mexico City?","answer":"The city matters less than the working model: most agencies on this list work remotely with clients across Mexico and Latin America. Monterrey concentrates agencies with an industrial and operations profile (Spidev, Varela Insights, InnovaBlack); Mexico City and Guadalajara concentrate more marketing- and sales-oriented agencies. Choose by specialty and by evidence of projects in production, not by postcode.","id":"6a93713477dc9a9d3cdb333f"},{"question":"Should I hire an agency or buy an AI SaaS tool?","answer":"A SaaS is the right call when your case is standard and needs no integration: an FAQ chatbot, for instance. An agency is the right call when the value lies in connecting AI to your real operation — your CRM, your ERP, your collections process — and in having someone accountable for the result. Many companies combine both: the agency builds on existing tools instead of reinventing them.","id":"6a93713477dc9a9d3cdb3340"},{"question":"How do I evaluate an artificial intelligence agency before hiring it?","answer":"Ask to see an agent running in production (not a demo), ask which tools and models they build with, how they handle errors and escalation to humans, who operates the system after delivery and how they measure results. Demand a proposal with fixed price and scope before starting, and be wary of guaranteed results.","id":"6a93713477dc9a9d3cdb3341"}],"relatedPosts":[],"categories":[{"id":1,"title":"AI agents","generateSlug":false,"slug":"agentes-de-ia","parent":null,"breadcrumbs":[{"doc":1,"url":"/agentes-de-ia","label":"AI agents","id":"6a6e6d2914168f5572e8e0b2"}],"updatedAt":"2026-08-01T22:20:55.875Z","createdAt":"2026-08-01T22:03:19.833Z"}],"meta":{"title":"Best AI agencies in Mexico 2026: agents & automation","image":{"id":85,"alt":"Card map of AI agent and automation agencies in Mexico in 2026, with Spidev in Monterrey highlighted","caption":null,"folder":null,"updatedAt":"2026-08-29T23:54:23.989Z","createdAt":"2026-08-29T23:54:21.329Z","url":"/api/media/file/hero.png","thumbnailURL":"/api/media/file/hero-300x169.png","filename":"hero.png","mimeType":"image/png","filesize":116653,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/hero-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":20546,"filename":"hero-300x169.png"},"square":{"url":"/api/media/file/hero-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":60881,"filename":"hero-500x500.png"},"small":{"url":"/api/media/file/hero-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":58565,"filename":"hero-600x338.png"},"medium":{"url":"/api/media/file/hero-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":104181,"filename":"hero-900x506.png"},"large":{"url":"/api/media/file/hero-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":193047,"filename":"hero-1400x788.png"},"xlarge":{"url":"/api/media/file/hero-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":278581,"filename":"hero-1920x1080.png"},"og":{"url":"/api/media/file/hero-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":147240,"filename":"hero-1200x630.png"}}},"description":"2026 comparison of AI agent and automation agencies in Mexico: Spidev, Magokoro, Brita, Adivor and more. Criteria, pricing and how to choose."},"publishedAt":"2026-08-29T15:00:00.000Z","readingTime":7,"authors":[1],"populatedAuthors":[{"id":1,"name":"shadow"}],"generateSlug":false,"slug":"best-ai-agent-automation-agencies-mexico-2026","updatedAt":"2026-08-30T00:29:59.059Z","createdAt":"2026-08-29T23:54:24.824Z","_status":"published"},{"id":2,"title":"Two Claude Code accounts on one machine: the complete guide","excerpt":"One laptop, two Claude accounts. A single environment variable gives each one its own history, memory and permissions — including the macOS detail almost no guide mentions.","heroImage":{"id":76,"alt":"Two terminal windows, one per Claude Code config directory, wired to the same claude command","caption":null,"folder":null,"updatedAt":"2026-08-22T23:21:43.980Z","createdAt":"2026-08-22T23:18:39.771Z","url":"/api/media/file/hero-1.png","thumbnailURL":"/api/media/file/hero-1-300x169.png","filename":"hero-1.png","mimeType":"image/png","filesize":98986,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/hero-1-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":16510,"filename":"hero-1-300x169.png"},"square":{"url":"/api/media/file/hero-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":42171,"filename":"hero-1-500x500.png"},"small":{"url":"/api/media/file/hero-1-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":39727,"filename":"hero-1-600x338.png"},"medium":{"url":"/api/media/file/hero-1-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":82736,"filename":"hero-1-900x506.png"},"large":{"url":"/api/media/file/hero-1-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":136284,"filename":"hero-1-1400x788.png"},"xlarge":{"url":"/api/media/file/hero-1-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":234242,"filename":"hero-1-1920x1080.png"},"og":{"url":"/api/media/file/hero-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":101508,"filename":"hero-1-1200x630.png"}}},"content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you have a Claude account through work and a personal subscription of your own, you already know the annoying part: Claude Code holds one login at a time. Switching means logging out of one account and into the other.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"And logging out costs more than it looks. Beyond the credential, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/logout","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" also resets your first-launch setup state, so the next time you start Claude Code it walks you through onboarding again. Your history, project memory and approved permissions stay on disk, but you stop working with them the moment the other account takes over.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"There is a clean fix that needs no extra tooling — and it is the one Anthropic's own documentation suggests. By the end of this guide you will have two accounts living on the same machine, each with its own history, memory and permissions, and you will know exactly what gets separated, what does not, and what to do if you are on macOS.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The 30-second version","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you just want the result, it is two lines in your shell config:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"# ~/.zshrc  (or ~/.bashrc on bash)\nalias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'\nalias claude-personal='CLAUDE_CONFIG_DIR=~/.claude-personal claude'","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8454"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Reload your shell with ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"source ~/.zshrc","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", run each alias once, and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" with the matching account. Done.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The rest of this article covers why it works, how to confirm the two accounts really are separate, the macOS detail almost no guide mentions, and what to do when that detail affects you.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What Claude Code keeps per account","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"By default, Claude Code works against a single directory: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" (on Windows, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"%USERPROFILE%\\.claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":"). That directory does not just hold your login — it holds nearly all of your accumulated context.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":78,"alt":"Diagram of what a Claude Code config directory holds and what separating it means","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"A config directory holds settings, history, transcripts, memory and plugins. Changing it separates all five at once.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-22T23:21:51.225Z","createdAt":"2026-08-22T23:18:45.210Z","url":"/api/media/file/isolation.en-1.png","thumbnailURL":"/api/media/file/isolation.en-1-300x169.png","filename":"isolation.en-1.png","mimeType":"image/png","filesize":123377,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/isolation.en-1-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":25654,"filename":"isolation.en-1-300x169.png"},"square":{"url":"/api/media/file/isolation.en-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":78209,"filename":"isolation.en-1-500x500.png"},"small":{"url":"/api/media/file/isolation.en-1-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":74431,"filename":"isolation.en-1-600x338.png"},"medium":{"url":"/api/media/file/isolation.en-1-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":137068,"filename":"isolation.en-1-900x506.png"},"large":{"url":"/api/media/file/isolation.en-1-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":248167,"filename":"isolation.en-1-1400x788.png"},"xlarge":{"url":"/api/media/file/isolation.en-1-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":374257,"filename":"isolation.en-1-1920x1080.png"},"og":{"url":"/api/media/file/isolation.en-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":195162,"filename":"isolation.en-1-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CONFIG_DIR","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" environment variable changes which directory that is. The ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"https://code.claude.com/docs/en/env-vars","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"environment variables reference","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" puts it this way:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"quote","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Override the configuration directory (default: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":"). All settings, session history, and plugins are stored under this path, as are credentials on Linux and Windows; on macOS, credentials are in the system Keychain. Useful for running multiple accounts side by side.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The full list of what lives in there is worth reading, because it explains why this feels so much cleaner than logging out and back in:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"settings.json","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — permissions, hooks, environment variables and your default model.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"history.jsonl","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — every prompt you have typed, with its project. This is what up-arrow recalls.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"projects/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — the full transcript of every session, plus the auto memory Claude writes to itself across sessions.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"plugins/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"skills/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"agents/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"commands/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"rules/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — everything you have installed or written to extend Claude Code.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"file-history/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — pre-edit snapshots of the files Claude changed, which is what makes checkpoint restore work.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":6,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":".credentials.json","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" — your login, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"on Linux and Windows only","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". We come back to this shortly.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"One Claude Code binary, as many independent states as you want directories. Nothing gets installed twice.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The setup, step by step","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 1 — Add the aliases","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"On zsh (the default shell on macOS) the file is ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.zshrc","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":". On bash, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.bashrc","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":". The two lines are identical either way:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'\nalias claude-personal='CLAUDE_CONFIG_DIR=~/.claude-personal claude'","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8455"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"You do not need to create the directories first — Claude Code creates them on the first run with that variable set. Reload the shell:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"source ~/.zshrc","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8456"},"format":"","version":2},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 2 — Log in once per alias","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Launch each one and run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" with the account it belongs to. This is the only time you have to do it.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"claude-work\n# inside Claude Code: /login  → your work account\n\nclaude-personal\n# inside Claude Code: /login  → your personal subscription","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8457"},"format":"","version":2},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 3 — Verify the separation actually happened","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This is the step almost every guide skips, and the only one that tells you whether the trick worked on your machine. Inside each alias, run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/status","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":": it shows the login method, the organization and the email behind the active session.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":82,"alt":"Daily-use diagram: each repository maps to one alias and one isolated state","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Day to day, only the command you type changes. The variable handles the rest.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-22T23:22:04.625Z","createdAt":"2026-08-22T23:18:55.169Z","url":"/api/media/file/routing.en-1.png","thumbnailURL":"/api/media/file/routing.en-1-300x154.png","filename":"routing.en-1.png","mimeType":"image/png","filesize":119817,"width":3200,"height":1640,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/routing.en-1-300x154.png","width":300,"height":154,"mimeType":"image/png","filesize":19137,"filename":"routing.en-1-300x154.png"},"square":{"url":"/api/media/file/routing.en-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":57535,"filename":"routing.en-1-500x500.png"},"small":{"url":"/api/media/file/routing.en-1-600x308.png","width":600,"height":308,"mimeType":"image/png","filesize":54916,"filename":"routing.en-1-600x308.png"},"medium":{"url":"/api/media/file/routing.en-1-900x461.png","width":900,"height":461,"mimeType":"image/png","filesize":100456,"filename":"routing.en-1-900x461.png"},"large":{"url":"/api/media/file/routing.en-1-1400x718.png","width":1400,"height":718,"mimeType":"image/png","filesize":188849,"filename":"routing.en-1-1400x718.png"},"xlarge":{"url":"/api/media/file/routing.en-1-1920x984.png","width":1920,"height":984,"mimeType":"image/png","filesize":293837,"filename":"routing.en-1-1920x984.png"},"og":{"url":"/api/media/file/routing.en-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":150844,"filename":"routing.en-1-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Open both aliases, run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/status","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" in each, and compare. Two different accounts means you are done. The same account in both means keep reading — you are in the macOS case.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"style":"info","content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Quick test: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"claude-work","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"claude-personal","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" in two tabs, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/status","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" in each. Thirty seconds and you know.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"blockType":"banner","id":"6a93b20ef8279e0004bd8458"},"format":"","version":2},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The macOS detail almost no guide mentions","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This is where the popular version of the technique gets imprecise. Most write-ups state flatly that each config directory keeps its own login. Anthropic's documentation is more specific than that.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":80,"alt":"Per-operating-system comparison of where the Claude Code credential is stored and whether the variable relocates it","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The detail almost no guide mentions: the docs scope credential relocation to Linux and Windows.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-22T23:21:58.023Z","createdAt":"2026-08-22T23:18:50.311Z","url":"/api/media/file/platforms.en-1.png","thumbnailURL":"/api/media/file/platforms.en-1-300x150.png","filename":"platforms.en-1.png","mimeType":"image/png","filesize":100211,"width":3200,"height":1600,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/platforms.en-1-300x150.png","width":300,"height":150,"mimeType":"image/png","filesize":20536,"filename":"platforms.en-1-300x150.png"},"square":{"url":"/api/media/file/platforms.en-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":63410,"filename":"platforms.en-1-500x500.png"},"small":{"url":"/api/media/file/platforms.en-1-600x300.png","width":600,"height":300,"mimeType":"image/png","filesize":58073,"filename":"platforms.en-1-600x300.png"},"medium":{"url":"/api/media/file/platforms.en-1-900x450.png","width":900,"height":450,"mimeType":"image/png","filesize":107659,"filename":"platforms.en-1-900x450.png"},"large":{"url":"/api/media/file/platforms.en-1-1400x700.png","width":1400,"height":700,"mimeType":"image/png","filesize":194582,"filename":"platforms.en-1-1400x700.png"},"xlarge":{"url":"/api/media/file/platforms.en-1-1920x960.png","width":1920,"height":960,"mimeType":"image/png","filesize":281832,"filename":"platforms.en-1-1920x960.png"},"og":{"url":"/api/media/file/platforms.en-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":168549,"filename":"platforms.en-1-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"https://code.claude.com/docs/en/authentication","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"authentication page","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" lists where the credential lives per platform: on macOS, in the encrypted system Keychain; on Linux, in ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.claude/.credentials.json","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" at file mode ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"0600","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":"; on Windows, inside your user profile. Then it adds a sentence worth reading slowly:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"quote","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you've set the ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CONFIG_DIR","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" environment variable ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"on Linux or Windows","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", the ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":".credentials.json","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" file lives under that directory instead.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Linux and Windows. macOS is not in that sentence, and the environment variable reference says explicitly that on macOS credentials are in the system Keychain. In other words: on macOS the config directory separates your settings, history, transcripts, memory and plugins — everything in the list above — but the docs do not describe per-directory credential separation.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What to do about it, practically: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"test it rather than assume it.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Run step 3. If ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/status","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" shows two different accounts, there is nothing left to solve. If it shows the same one, the fix below is deterministic.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If the two accounts collide: the token route","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Claude Code can authenticate with a long-lived OAuth token that, per the docs, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"takes precedence over keychain-stored credentials","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". That turns the account into something defined per alias rather than per machine.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Generate one token per account. The command opens the same browser flow as ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" and prints the token when you approve:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"claude setup-token","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8459"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Then bind each token to its alias:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work CLAUDE_CODE_OAUTH_TOKEN=$(security find-generic-password -s claude-token-work -w) claude'\nalias claude-personal='CLAUDE_CONFIG_DIR=~/.claude-personal CLAUDE_CODE_OAUTH_TOKEN=$(security find-generic-password -s claude-token-personal -w) claude'","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd845a"},"format":"","version":2},{"type":"block","fields":{"style":"warning","content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Do not paste the token straight into ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.zshrc","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":": that is a plaintext credential in a file you probably back up or sync. Put it in the Keychain (","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"security add-generic-password -s claude-token-work -a $USER -w","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":") or the password manager you already use, and read it from there as shown above.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"blockType":"banner","id":"6a93b20ef8279e0004bd845b"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The token has limits worth knowing before you adopt it:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It lasts one year and requires a Pro, Max, Team or Enterprise plan.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It can only make model requests: it cannot establish Remote Control sessions or fetch claude.ai connectors.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Renewing means generating a new one and restarting the session.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"--bare","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" mode does not read it; there you need ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"ANTHROPIC_API_KEY","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" or an ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"apiKeyHelper","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" instead.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"For most people on macOS the plain aliases are enough and this section is unnecessary. It is here for when they are not.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Windows and PowerShell","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The alias syntax is zsh/bash, so it works as-is in Git Bash or WSL. In native PowerShell, use functions and add them to your profile (","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"$PROFILE","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":"):","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"function claude-work     { $env:CLAUDE_CONFIG_DIR = \"$HOME\\.claude-work\";     claude @args }\nfunction claude-personal { $env:CLAUDE_CONFIG_DIR = \"$HOME\\.claude-personal\"; claude @args }","language":"powershell","blockType":"code","id":"6a93b20ef8279e0004bd845c"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Reload with ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":". $PROFILE","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", then run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" once per command. On Windows the credential does move with the directory, so the isolation is complete from the start.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Making it automatic","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Two aliases cover the common case, but if you spend all day hopping between folders you will eventually type the wrong one. A function that decides from the path removes that:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"# ~/.zshrc — one command that picks the account from where you are\nclaude() {\n  case \"$PWD/\" in\n    \"$HOME\"/work/*) export CLAUDE_CONFIG_DIR=\"$HOME/.claude-work\" ;;\n    *)              export CLAUDE_CONFIG_DIR=\"$HOME/.claude-personal\" ;;\n  esac\n  command claude \"$@\"\n}","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd845d"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"From then on you always type ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" and the folder decides. Run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/status","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" the first time in each new repository to confirm it landed where you expected.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"style":"info","content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The variable is resolved ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"before","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Claude Code reads ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"settings.json","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", so putting it in a settings file's ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"env","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" block does not work. It has to be in the environment before the process starts.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"blockType":"banner","id":"6a93b20ef8279e0004bd845e"},"format":"","version":2},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"A bonus: naming the project directory","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you share paths across accounts, ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CODE_PROJECT_DIR_NAME","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" (from version 2.1.234) lets you choose the name that session's transcripts and memory are stored under, instead of deriving it from the working directory path:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"CLAUDE_CONFIG_DIR=~/.claude-work CLAUDE_CODE_PROJECT_DIR_NAME=api-service claude","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd845f"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It is ignored when ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CONFIG_DIR","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" is unset, and it is only read from the environment you start ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" from.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Moving an account you already have","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you have been using Claude Code with a single account for months, do not start from scratch: copy the existing directory to the new name and leave ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.claude","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" for the second account.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"block","fields":{"code":"cp -R ~/.claude ~/.claude-work\nclaude-work   # /status to confirm the history and memory came along","language":"bash","blockType":"code","id":"6a93b20ef8279e0004bd8460"},"format":"","version":2},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Copy rather than move until you have verified everything is in place. On Linux and Windows the credential travels with the folder; on macOS you will need to ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" again in at least one of the two aliases.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What this does not separate","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"upload","value":{"id":84,"alt":"Cards showing three things the config-directory trick does not separate","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Knowing what does not get separated prevents half of the second-week surprises.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-22T23:22:10.692Z","createdAt":"2026-08-22T23:18:59.925Z","url":"/api/media/file/pitfalls.en-1.png","thumbnailURL":"/api/media/file/pitfalls.en-1-300x143.png","filename":"pitfalls.en-1.png","mimeType":"image/png","filesize":112294,"width":3200,"height":1520,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/pitfalls.en-1-300x143.png","width":300,"height":143,"mimeType":"image/png","filesize":20658,"filename":"pitfalls.en-1-300x143.png"},"square":{"url":"/api/media/file/pitfalls.en-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":60742,"filename":"pitfalls.en-1-500x500.png"},"small":{"url":"/api/media/file/pitfalls.en-1-600x285.png","width":600,"height":285,"mimeType":"image/png","filesize":59164,"filename":"pitfalls.en-1-600x285.png"},"medium":{"url":"/api/media/file/pitfalls.en-1-900x428.png","width":900,"height":428,"mimeType":"image/png","filesize":106223,"filename":"pitfalls.en-1-900x428.png"},"large":{"url":"/api/media/file/pitfalls.en-1-1400x665.png","width":1400,"height":665,"mimeType":"image/png","filesize":196803,"filename":"pitfalls.en-1-1400x665.png"},"xlarge":{"url":"/api/media/file/pitfalls.en-1-1920x912.png","width":1920,"height":912,"mimeType":"image/png","filesize":300494,"filename":"pitfalls.en-1-1920x912.png"},"og":{"url":"/api/media/file/pitfalls.en-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":173432,"filename":"pitfalls.en-1-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Three limits worth being clear about up front, because they explain nearly every second-week surprise:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Repository files.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" A project's ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE.md","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":".claude/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" folder live in the repo. Both accounts read them the same way, and they should: that is project context, not yours.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Managed settings.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Policies your organization deploys apply at the machine level and outrank anything you put in any config directory.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Transcripts are not encrypted.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Whatever passes through a tool is written in plaintext under ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"projects/","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":". Separating directories keeps them from mixing, not from existing: if a client requires that nothing is left behind, tune ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"cleanupPeriodDays","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" or use ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"claude project purge","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If something does not work","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Both aliases show the same account.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" That is the macOS case above. Use the token route.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The alias is gone after restarting the terminal.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" The line went into the wrong file. On macOS with zsh it is ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.zshrc","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", not ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.bash_profile","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It starts as if it were the first run.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Expected: a fresh directory has no state. Go through onboarding once and it sticks.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Your history disappeared after switching.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" It did not — it is in the other directory. Start the other alias and up-arrow works again.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"A login-expiry warning.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" Claude Code warns three days ahead. Run ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"/login","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" in the alias it belongs to; nothing is blocked until it actually expires.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Before you do this: an honest note","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This separates contexts between two accounts that are already yours. It is not a way to multiply usage limits or share one subscription across several people: the terms are one account per person, and a company seat usually comes with a policy about what you may use it for. Check that policy before pointing your work seat at a personal project.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If the problem you are actually solving is that several people on the team share one login, the answer is not aliases: it is a Team or Enterprise plan with a seat per person, central billing and managed policies.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"horizontalrule","version":1},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Further reading","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"type":"link","fields":{"url":"https://code.claude.com/docs/en/env-vars","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"Claude Code environment variables","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" — the definitions of ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CONFIG_DIR","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"CLAUDE_CODE_PROJECT_DIR_NAME","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"type":"link","fields":{"url":"https://code.claude.com/docs/en/authentication","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"Authentication and credential management","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" — where the login lives per platform and the precedence order between credentials.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"type":"link","fields":{"url":"https://code.claude.com/docs/en/claude-directory","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"The ~/.claude directory","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" — the full inventory of what is stored and for how long.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"}],"direction":"ltr"}},"faqs":[{"question":"Can you use two Claude Code accounts on the same computer?","answer":"Yes. Claude Code keeps each account's state in a config directory, and the CLAUDE_CONFIG_DIR environment variable decides which one it uses. With one alias per account (for example claude-work and claude-personal), each keeps its own settings, history, transcripts, project memory and plugins separately, from a single Claude Code installation.","id":"6a8a2f2934d8c1d486a7ca0b"},{"question":"What exactly does CLAUDE_CONFIG_DIR do?","answer":"It overrides the configuration directory, which defaults to ~/.claude. All settings, session history and plugins are stored under that path, as are credentials on Linux and Windows. On macOS credentials live in the system Keychain. The variable has to be in the environment before you launch claude: putting it in the env block of a settings.json file does not work.","id":"6a8a2f2934d8c1d486a7ca0c"},{"question":"Does it work the same on macOS as on Linux and Windows?","answer":"Not quite. On Linux and Windows the docs state that the .credentials.json file moves inside the directory you name, so the isolation is complete. On macOS credentials live in the system Keychain, and the docs scope that relocation to Linux and Windows. Everything else — settings, history, transcripts, memory and plugins — is separated on all three platforms. Check your own case by running /status inside each alias.","id":"6a8a2f2934d8c1d486a7ca0d"},{"question":"What if both accounts still show the same login on macOS?","answer":"Generate a long-lived token per account with claude setup-token and export it as CLAUDE_CODE_OAUTH_TOKEN inside each alias, since it takes precedence over keychain-stored credentials. Store each token in the Keychain or your password manager and read it from there; do not write it in plaintext into ~/.zshrc. Note that the token lasts one year and can only make model requests.","id":"6a8a2f2934d8c1d486a7ca0e"},{"question":"Do you lose your history when switching accounts?","answer":"No. Each directory keeps its own history.jsonl, its transcripts under projects/ and its auto memory. When you go back to the other alias, up-arrow recall and project memory are exactly where you left them. That is precisely the advantage over logging out and back in, which also resets your first-launch setup state.","id":"6a8a2f2934d8c1d486a7ca0f"},{"question":"What does not get separated by using different directories?","answer":"Three things. A repository's CLAUDE.md and .claude/ folder, because they live in the project rather than in your config directory. Managed settings deployed by your organization, which apply per machine. And the fact that transcripts are written in plaintext: separating directories keeps them from mixing, not from existing.","id":"6a8a2f2934d8c1d486a7ca10"},{"question":"Is this allowed under the terms of service?","answer":"Running two accounts that are already yours — your company seat and your personal subscription — on one machine is fine; it is the case Anthropic's own documentation calls out. What is not fine is sharing one subscription across several people or chaining accounts to extend usage limits. Also check your employer's policy on which projects you may use the work seat for.","id":"6a8a2f2934d8c1d486a7ca11"}],"relatedPosts":[],"categories":[{"id":2,"title":"Claude Code","generateSlug":false,"slug":"claude-code","parent":null,"breadcrumbs":[{"doc":2,"url":"/claude-code","label":"Claude Code","id":"6a8a2e67d8fbeec8ca9c0f5e"}],"updatedAt":"2026-08-22T23:22:11.327Z","createdAt":"2026-08-22T23:19:02.327Z"}],"meta":{"title":"How to run two Claude Code accounts on one machine (2026) | Spidev","image":{"id":76,"alt":"Two terminal windows, one per Claude Code config directory, wired to the same claude command","caption":null,"folder":null,"updatedAt":"2026-08-22T23:21:43.980Z","createdAt":"2026-08-22T23:18:39.771Z","url":"/api/media/file/hero-1.png","thumbnailURL":"/api/media/file/hero-1-300x169.png","filename":"hero-1.png","mimeType":"image/png","filesize":98986,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/hero-1-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":16510,"filename":"hero-1-300x169.png"},"square":{"url":"/api/media/file/hero-1-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":42171,"filename":"hero-1-500x500.png"},"small":{"url":"/api/media/file/hero-1-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":39727,"filename":"hero-1-600x338.png"},"medium":{"url":"/api/media/file/hero-1-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":82736,"filename":"hero-1-900x506.png"},"large":{"url":"/api/media/file/hero-1-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":136284,"filename":"hero-1-1400x788.png"},"xlarge":{"url":"/api/media/file/hero-1-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":234242,"filename":"hero-1-1920x1080.png"},"og":{"url":"/api/media/file/hero-1-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":101508,"filename":"hero-1-1200x630.png"}}},"description":"Complete guide to separating your work and personal Claude Code accounts with CLAUDE_CONFIG_DIR: aliases, verifying with /status, the macOS exception, and how to automate it."},"publishedAt":"2026-08-22T15:00:00.000Z","readingTime":7,"authors":[1],"populatedAuthors":[{"id":1,"name":"shadow"}],"generateSlug":false,"slug":"two-claude-code-accounts-one-machine","updatedAt":"2026-08-22T23:22:17.007Z","createdAt":"2026-08-22T23:19:04.618Z","_status":"published"},{"id":1,"title":"Step-by-step guide: how to set up Buzz.xyz and your first AI agent workspace","excerpt":"Buzz, Jack Dorsey's Nostr-based workspace, treats AI agents as participants with identities of their own. We documented all 12 setup screens, in order, and what to actually expect from the product.","heroImage":{"id":43,"alt":"Buzz.xyz home page: \"Where people and agents work together\"","caption":null,"folder":null,"updatedAt":"2026-08-01T22:19:38.828Z","createdAt":"2026-08-01T22:19:36.783Z","url":"/api/media/file/00-hero.png","thumbnailURL":"/api/media/file/00-hero-300x169.png","filename":"00-hero.png","mimeType":"image/png","filesize":371897,"width":1920,"height":1080,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/00-hero-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":14588,"filename":"00-hero-300x169.png"},"square":{"url":"/api/media/file/00-hero-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":60067,"filename":"00-hero-500x500.png"},"small":{"url":"/api/media/file/00-hero-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":54003,"filename":"00-hero-600x338.png"},"medium":{"url":"/api/media/file/00-hero-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":110539,"filename":"00-hero-900x506.png"},"large":{"url":"/api/media/file/00-hero-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":243322,"filename":"00-hero-1400x788.png"},"xlarge":{"url":"/api/media/file/00-hero-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":345280,"filename":"00-hero-1920x1080.png"},"og":{"url":"/api/media/file/00-hero-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":180651,"filename":"00-hero-1200x630.png"}}},"content":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz does not behave like Slack, Discord, or any AI tool you have used. Before you can create a channel, it asks you to generate an identity key. Before you invite anyone, it asks you to connect that identity to a community. And before an agent can help, that agent gets its own profile, its own permissions, and its own model.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"That is a lot for day one. We set up our first Buzz workspace to find out how far Block actually took the idea that people and agents should be the same kind of participant, and we documented every screen in the exact order it appears.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"By the end of this guide you will have a Buzz community, your own profile, and a starter team of agents ready to work alongside you in channels. You will also know whether it is worth your team's time.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Before you start: is Buzz for you?","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Worth saying plainly: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Buzz is promising, but it is not ready for the average user yet.","type":"text","style":"","detail":0,"format":1,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"quote","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you want an install-and-go experience like Slack or ChatGPT, Buzz will frustrate you. Setup is not trivial, and the underlying concepts — cryptographic keys, relays — are not self-evident. It is in early alpha/beta: you will hit bugs, and things will not always work on the first attempt.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Is it worth the effort? If you are a developer, a technical founder, or someone who needs to understand where human-agent collaboration is heading, yes. If you want a tool that simply works with no learning curve, wait a few months for the product to mature.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Why Block is building Buzz","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"upload","value":{"id":67,"alt":"Diagram: six disconnected SaaS tools versus one workspace on an open protocol","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Block's thesis in one image: replace six vendors with a protocol you control.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:36.971Z","createdAt":"2026-08-01T22:20:35.372Z","url":"/api/media/file/why.en.png","thumbnailURL":"/api/media/file/why.en-300x169.png","filename":"why.en.png","mimeType":"image/png","filesize":111748,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/why.en-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":21139,"filename":"why.en-300x169.png"},"square":{"url":"/api/media/file/why.en-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":65782,"filename":"why.en-500x500.png"},"small":{"url":"/api/media/file/why.en-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":61036,"filename":"why.en-600x338.png"},"medium":{"url":"/api/media/file/why.en-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":108681,"filename":"why.en-900x506.png"},"large":{"url":"/api/media/file/why.en-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":201786,"filename":"why.en-1400x788.png"},"xlarge":{"url":"/api/media/file/why.en-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":303222,"filename":"why.en-1920x1080.png"},"og":{"url":"/api/media/file/why.en-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":154163,"filename":"why.en-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz is not a side project: it follows directly from ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Jack Dorsey's","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" thesis about where the internet should go. Dorsey, co-founder of Twitter and now head of ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Block","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", has spent years redirecting his attention toward open, decentralised protocols. Buzz is the most ambitious expression of that shift.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"By building on ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"https://nostr.com/","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"Nostr","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":" — a protocol Dorsey has personally funded with millions — Buzz aims to replace the \"SaaS tax\" of running Slack, GitHub, a task tracker and an AI assistant separately, with a single workspace where humans and agents hold the same cryptographic standing.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"In that vision agents are not background tools but verifiable participants with identities of their own. Your data, your team's history and your agents' reputations belong to you rather than to a platform. That makes Buzz more than a chat app: it is a high-stakes experiment to prove that the future of work can be open, auditable, and independent of any single vendor.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What Buzz is, in plain words","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz is a workspace where people and AI agents operate in the same channels.","type":"text","style":"","detail":0,"format":1,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It has what you would expect: messages, channels, search and direct messages. The difference is that an agent is treated as a real participant in the workspace. It has its own identity, its own settings, and a record of the work it does.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":69,"alt":"Architecture diagram: people and agents connected to a shared relay and channels","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"People and agents are the same kind of participant. The relay is the shared record.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:41.406Z","createdAt":"2026-08-01T22:20:39.850Z","url":"/api/media/file/architecture.en.png","thumbnailURL":"/api/media/file/architecture.en-300x169.png","filename":"architecture.en.png","mimeType":"image/png","filesize":107487,"width":3200,"height":1800,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/architecture.en-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":18493,"filename":"architecture.en-300x169.png"},"square":{"url":"/api/media/file/architecture.en-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":58587,"filename":"architecture.en-500x500.png"},"small":{"url":"/api/media/file/architecture.en-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":53287,"filename":"architecture.en-600x338.png"},"medium":{"url":"/api/media/file/architecture.en-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":93091,"filename":"architecture.en-900x506.png"},"large":{"url":"/api/media/file/architecture.en-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":178021,"filename":"architecture.en-1400x788.png"},"xlarge":{"url":"/api/media/file/architecture.en-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":274663,"filename":"architecture.en-1920x1080.png"},"og":{"url":"/api/media/file/architecture.en-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":128258,"filename":"architecture.en-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Block released it as an open-source project on Nostr, a protocol that uses cryptographic keys as identity. In practical terms: you, your teammates and your agents get identities that are harder to fake and easier to verify.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"For a first install you only need to hold on to four ideas:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":71,"alt":"Cards showing Buzz's four base concepts: identity key, relay, community and agent","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Four concepts. Once these land, the rest of the install is mechanical.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:45.901Z","createdAt":"2026-08-01T22:20:44.368Z","url":"/api/media/file/concepts.en.png","thumbnailURL":"/api/media/file/concepts.en-300x143.png","filename":"concepts.en.png","mimeType":"image/png","filesize":122922,"width":3200,"height":1520,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/concepts.en-300x143.png","width":300,"height":143,"mimeType":"image/png","filesize":20389,"filename":"concepts.en-300x143.png"},"square":{"url":"/api/media/file/concepts.en-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":61025,"filename":"concepts.en-500x500.png"},"small":{"url":"/api/media/file/concepts.en-600x285.png","width":600,"height":285,"mimeType":"image/png","filesize":60571,"filename":"concepts.en-600x285.png"},"medium":{"url":"/api/media/file/concepts.en-900x428.png","width":900,"height":428,"mimeType":"image/png","filesize":109557,"filename":"concepts.en-900x428.png"},"large":{"url":"/api/media/file/concepts.en-1400x665.png","width":1400,"height":665,"mimeType":"image/png","filesize":206081,"filename":"concepts.en-1400x665.png"},"xlarge":{"url":"/api/media/file/concepts.en-1920x912.png","width":1920,"height":912,"mimeType":"image/png","filesize":332240,"filename":"concepts.en-1920x912.png"},"og":{"url":"/api/media/file/concepts.en-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":184935,"filename":"concepts.en-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What you need before installing Buzz.xyz","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Download the desktop app from ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"https://buzz.xyz/","newTab":true,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"buzz.xyz","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":". You will also need an email address, because the hosted community setup runs through ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Builderlab","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you already use Claude Code or Codex, keep it in mind for later: Buzz can detect them and connect them as agent harnesses. You do not need to configure them on the first pass.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Understand the relay before you touch anything","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The \"relay\" is the part that confuses people most. In one sentence: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"the relay is your team's hard drive.","type":"text","style":"","detail":0,"format":1,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Slack stores your data on its own servers. Buzz stores it on a relay that follows an open protocol. That is why the data is yours, and also why setup takes more work. You have two paths:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Use Block's hosted relay.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" The simple, free option: Block runs and maintains it, your community lives there, and you administer no infrastructure. It is what almost everyone picks at first.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Host your own relay.","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" For teams that want full control of their data. You run it on your own server or a cloud provider (Railway, DigitalOcean, AWS). It costs roughly $5–50 per month depending on team size, but everything is yours.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This guide uses the hosted relay through Builderlab. If you want to self-host later you can migrate or run both in parallel — the setup process is the same either way. The option lives in Settings.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":44,"alt":"Buzz settings screen showing the relay configuration","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The relay is configured from Settings. It is the single most consequential infrastructure choice in the process.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:41.232Z","createdAt":"2026-08-01T22:19:39.552Z","url":"/api/media/file/04-relay-settings.png","thumbnailURL":"/api/media/file/04-relay-settings-300x160.png","filename":"04-relay-settings.png","mimeType":"image/png","filesize":531411,"width":2616,"height":1394,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/04-relay-settings-300x160.png","width":300,"height":160,"mimeType":"image/png","filesize":20543,"filename":"04-relay-settings-300x160.png"},"square":{"url":"/api/media/file/04-relay-settings-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":45325,"filename":"04-relay-settings-500x500.png"},"small":{"url":"/api/media/file/04-relay-settings-600x320.png","width":600,"height":320,"mimeType":"image/png","filesize":62531,"filename":"04-relay-settings-600x320.png"},"medium":{"url":"/api/media/file/04-relay-settings-900x480.png","width":900,"height":480,"mimeType":"image/png","filesize":117738,"filename":"04-relay-settings-900x480.png"},"large":{"url":"/api/media/file/04-relay-settings-1400x746.png","width":1400,"height":746,"mimeType":"image/png","filesize":240470,"filename":"04-relay-settings-1400x746.png"},"xlarge":{"url":"/api/media/file/04-relay-settings-1920x1023.png","width":1920,"height":1023,"mimeType":"image/png","filesize":482202,"filename":"04-relay-settings-1920x1023.png"},"og":{"url":"/api/media/file/04-relay-settings-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":198055,"filename":"04-relay-settings-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step-by-step setup guide for Buzz.xyz","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 1 — Create your Buzz identity","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Open Buzz. The first screen offers two paths: create a new identity key, or use one you already have.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Choose ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Create a new identity key","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" if this is your first time. The existing-key option only applies if you have set Buzz up before and saved that key.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":45,"alt":"Buzz welcome screen with options to create or use an identity key","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 1 — Buzz opens by asking for an identity, not an email address.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:43.699Z","createdAt":"2026-08-01T22:19:42.346Z","url":"/api/media/file/05-identity-welcome.webp","thumbnailURL":"/api/media/file/05-identity-welcome-300x195.webp","filename":"05-identity-welcome.webp","mimeType":"image/webp","filesize":42746,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/05-identity-welcome-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":2506,"filename":"05-identity-welcome-300x195.webp"},"square":{"url":"/api/media/file/05-identity-welcome-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":8792,"filename":"05-identity-welcome-500x500.webp"},"small":{"url":"/api/media/file/05-identity-welcome-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":6746,"filename":"05-identity-welcome-600x389.webp"},"medium":{"url":"/api/media/file/05-identity-welcome-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":12170,"filename":"05-identity-welcome-900x584.webp"},"large":{"url":"/api/media/file/05-identity-welcome-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":25920,"filename":"05-identity-welcome-1400x908.webp"},"xlarge":{"url":"/api/media/file/05-identity-welcome-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":40936,"filename":"05-identity-welcome-1920x1246.webp"},"og":{"url":"/api/media/file/05-identity-welcome-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":18610,"filename":"05-identity-welcome-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 2 — Save the private key before moving on","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz generates your key and stores it in your operating system's keychain. That is fine for daily use, but it is not a backup.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Copy the key and store it in a password manager or another private place you control. Do not paste it into a document, a chat app or an email draft. Anyone holding that private key can act as you inside Buzz, and there is no recovery button.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Then click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Next","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":46,"alt":"Buzz screen warning you to store the private identity key safely","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 2 — The system keychain is not a backup. Copy the key into a password manager.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:46.334Z","createdAt":"2026-08-01T22:19:44.811Z","url":"/api/media/file/06-save-private-key.webp","thumbnailURL":"/api/media/file/06-save-private-key-300x195.webp","filename":"06-save-private-key.webp","mimeType":"image/webp","filesize":98478,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/06-save-private-key-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":3266,"filename":"06-save-private-key-300x195.webp"},"square":{"url":"/api/media/file/06-save-private-key-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":13148,"filename":"06-save-private-key-500x500.webp"},"small":{"url":"/api/media/file/06-save-private-key-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":9508,"filename":"06-save-private-key-600x389.webp"},"medium":{"url":"/api/media/file/06-save-private-key-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":20292,"filename":"06-save-private-key-900x584.webp"},"large":{"url":"/api/media/file/06-save-private-key-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":51138,"filename":"06-save-private-key-1400x908.webp"},"xlarge":{"url":"/api/media/file/06-save-private-key-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":90240,"filename":"06-save-private-key-1920x1246.webp"},"og":{"url":"/api/media/file/06-save-private-key-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":35106,"filename":"06-save-private-key-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 3 — Decide whether to connect Claude Code or Codex now","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz checks whether you already have AI coding tools installed. On our machine it found Claude Code and Codex, though the ACP adapters were still missing.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If you already know how you want to use those tools, set them up here. If you would rather get in and look around first, click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Skip for now","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — you can come back whenever you like.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This design decision matters more than it looks. Your workspace does not depend on a single model: you bring the provider you prefer and change it later.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":47,"alt":"Buzz agent harness setup showing detected Claude Code and Codex CLIs","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 3 — Buzz detects installed CLIs. Skipping this step costs you nothing.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:48.868Z","createdAt":"2026-08-01T22:19:47.444Z","url":"/api/media/file/07-agent-harness.webp","thumbnailURL":"/api/media/file/07-agent-harness-300x195.webp","filename":"07-agent-harness.webp","mimeType":"image/webp","filesize":77510,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/07-agent-harness-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":2214,"filename":"07-agent-harness-300x195.webp"},"square":{"url":"/api/media/file/07-agent-harness-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":10428,"filename":"07-agent-harness-500x500.webp"},"small":{"url":"/api/media/file/07-agent-harness-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":7264,"filename":"07-agent-harness-600x389.webp"},"medium":{"url":"/api/media/file/07-agent-harness-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":15498,"filename":"07-agent-harness-900x584.webp"},"large":{"url":"/api/media/file/07-agent-harness-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":40532,"filename":"07-agent-harness-1400x908.webp"},"xlarge":{"url":"/api/media/file/07-agent-harness-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":72864,"filename":"07-agent-harness-1920x1246.webp"},"og":{"url":"/api/media/file/07-agent-harness-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":27544,"filename":"07-agent-harness-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 4 — Choose how you want to enter Buzz","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz asks where you want to work. You can join an existing community with an invite, reconnect to one you already own, or create a new one.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"For a new team space, choose ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Create a community","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":48,"alt":"Buzz community options: join, create, or reconnect","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 4 — Three paths. For a new workspace, pick \"Create a community\".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:51.387Z","createdAt":"2026-08-01T22:19:49.945Z","url":"/api/media/file/08-community-choices.webp","thumbnailURL":"/api/media/file/08-community-choices-300x195.webp","filename":"08-community-choices.webp","mimeType":"image/webp","filesize":48060,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/08-community-choices-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":2006,"filename":"08-community-choices-300x195.webp"},"square":{"url":"/api/media/file/08-community-choices-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":7482,"filename":"08-community-choices-500x500.webp"},"small":{"url":"/api/media/file/08-community-choices-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":5876,"filename":"08-community-choices-600x389.webp"},"medium":{"url":"/api/media/file/08-community-choices-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":10888,"filename":"08-community-choices-900x584.webp"},"large":{"url":"/api/media/file/08-community-choices-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":25594,"filename":"08-community-choices-1400x908.webp"},"xlarge":{"url":"/api/media/file/08-community-choices-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":43036,"filename":"08-community-choices-1920x1246.webp"},"og":{"url":"/api/media/file/08-community-choices-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":17350,"filename":"08-community-choices-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 5 — Builderlab takes over","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz explains that it will open Builderlab in your browser. Builderlab is the service that creates your hosted relay and manages the community.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Sign in to continue","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" and the browser opens on its own.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":49,"alt":"Buzz modal explaining that Builderlab will set up the community","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 5 — Buzz hands the hosted relay creation over to Builderlab.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:54.024Z","createdAt":"2026-08-01T22:19:52.488Z","url":"/api/media/file/09-builderlab-handoff.webp","thumbnailURL":"/api/media/file/09-builderlab-handoff-300x195.webp","filename":"09-builderlab-handoff.webp","mimeType":"image/webp","filesize":118972,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/09-builderlab-handoff-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":1982,"filename":"09-builderlab-handoff-300x195.webp"},"square":{"url":"/api/media/file/09-builderlab-handoff-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":13484,"filename":"09-builderlab-handoff-500x500.webp"},"small":{"url":"/api/media/file/09-builderlab-handoff-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":7644,"filename":"09-builderlab-handoff-600x389.webp"},"medium":{"url":"/api/media/file/09-builderlab-handoff-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":20238,"filename":"09-builderlab-handoff-900x584.webp"},"large":{"url":"/api/media/file/09-builderlab-handoff-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":55778,"filename":"09-builderlab-handoff-1400x908.webp"},"xlarge":{"url":"/api/media/file/09-builderlab-handoff-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":107532,"filename":"09-builderlab-handoff-1920x1246.webp"},"og":{"url":"/api/media/file/09-builderlab-handoff-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":39160,"filename":"09-builderlab-handoff-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 6 — Sign in and verify your email","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"In Builderlab, enter your email and click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Continue","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". If you do not have an account, the sign-up link is on the same screen.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":50,"alt":"Builderlab login screen for the Buzz setup","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 6 — The only point in the process where an email address is required.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:56.415Z","createdAt":"2026-08-01T22:19:55.079Z","url":"/api/media/file/10-builderlab-login.webp","thumbnailURL":"/api/media/file/10-builderlab-login-300x177.webp","filename":"10-builderlab-login.webp","mimeType":"image/webp","filesize":22356,"width":2048,"height":1210,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/10-builderlab-login-300x177.webp","width":300,"height":177,"mimeType":"image/webp","filesize":1534,"filename":"10-builderlab-login-300x177.webp"},"square":{"url":"/api/media/file/10-builderlab-login-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":6082,"filename":"10-builderlab-login-500x500.webp"},"small":{"url":"/api/media/file/10-builderlab-login-600x354.webp","width":600,"height":354,"mimeType":"image/webp","filesize":4092,"filename":"10-builderlab-login-600x354.webp"},"medium":{"url":"/api/media/file/10-builderlab-login-900x532.webp","width":900,"height":532,"mimeType":"image/webp","filesize":8874,"filename":"10-builderlab-login-900x532.webp"},"large":{"url":"/api/media/file/10-builderlab-login-1400x827.webp","width":1400,"height":827,"mimeType":"image/webp","filesize":15650,"filename":"10-builderlab-login-1400x827.webp"},"xlarge":{"url":"/api/media/file/10-builderlab-login-1920x1134.webp","width":1920,"height":1134,"mimeType":"image/webp","filesize":22234,"filename":"10-builderlab-login-1920x1134.webp"},"og":{"url":"/api/media/file/10-builderlab-login-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":11982,"filename":"10-builderlab-login-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Builderlab sends a verification link. Open it, return to this page, and click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"I've verified my email","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". If the email does not arrive, check spam before resending; the resend button is best used only after a few minutes.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":51,"alt":"Builderlab email verification screen","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 6b — Verify the address before continuing. Check spam before hitting resend.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:19:58.816Z","createdAt":"2026-08-01T22:19:57.426Z","url":"/api/media/file/11-email-verification.webp","thumbnailURL":"/api/media/file/11-email-verification-300x176.webp","filename":"11-email-verification.webp","mimeType":"image/webp","filesize":41848,"width":2048,"height":1204,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/11-email-verification-300x176.webp","width":300,"height":176,"mimeType":"image/webp","filesize":2844,"filename":"11-email-verification-300x176.webp"},"square":{"url":"/api/media/file/11-email-verification-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":13684,"filename":"11-email-verification-500x500.webp"},"small":{"url":"/api/media/file/11-email-verification-600x353.webp","width":600,"height":353,"mimeType":"image/webp","filesize":8418,"filename":"11-email-verification-600x353.webp"},"medium":{"url":"/api/media/file/11-email-verification-900x529.webp","width":900,"height":529,"mimeType":"image/webp","filesize":17010,"filename":"11-email-verification-900x529.webp"},"large":{"url":"/api/media/file/11-email-verification-1400x823.webp","width":1400,"height":823,"mimeType":"image/webp","filesize":28642,"filename":"11-email-verification-1400x823.webp"},"xlarge":{"url":"/api/media/file/11-email-verification-1920x1129.webp","width":1920,"height":1129,"mimeType":"image/webp","filesize":42016,"filename":"11-email-verification-1920x1129.webp"},"og":{"url":"/api/media/file/11-email-verification-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":23296,"filename":"11-email-verification-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 7 — Connect your Buzz identity to Builderlab","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Builderlab needs to know which identity will own the community. Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Connect your Buzz identity","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":52,"alt":"Builderlab community-access screen with the connect identity button","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 7 — Builderlab needs to know which identity will own the community.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:01.268Z","createdAt":"2026-08-01T22:19:59.859Z","url":"/api/media/file/12-connect-identity.webp","thumbnailURL":"/api/media/file/12-connect-identity-300x178.webp","filename":"12-connect-identity.webp","mimeType":"image/webp","filesize":37654,"width":2048,"height":1212,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/12-connect-identity-300x178.webp","width":300,"height":178,"mimeType":"image/webp","filesize":2944,"filename":"12-connect-identity-300x178.webp"},"square":{"url":"/api/media/file/12-connect-identity-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":10934,"filename":"12-connect-identity-500x500.webp"},"small":{"url":"/api/media/file/12-connect-identity-600x355.webp","width":600,"height":355,"mimeType":"image/webp","filesize":8094,"filename":"12-connect-identity-600x355.webp"},"medium":{"url":"/api/media/file/12-connect-identity-900x533.webp","width":900,"height":533,"mimeType":"image/webp","filesize":14910,"filename":"12-connect-identity-900x533.webp"},"large":{"url":"/api/media/file/12-connect-identity-1400x829.webp","width":1400,"height":829,"mimeType":"image/webp","filesize":25994,"filename":"12-connect-identity-1400x829.webp"},"xlarge":{"url":"/api/media/file/12-connect-identity-1920x1136.webp","width":1920,"height":1136,"mimeType":"image/webp","filesize":37538,"filename":"12-connect-identity-1920x1136.webp"},"og":{"url":"/api/media/file/12-connect-identity-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":20072,"filename":"12-connect-identity-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Builderlab gives you a six-digit code. Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Copy code and open Buzz","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — that sends you back to the desktop app, where Buzz completes the connection.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":53,"alt":"Builderlab screen showing a six-digit pairing code for the Buzz desktop app","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 7b — The six-digit code pairs the browser with the desktop app.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:03.702Z","createdAt":"2026-08-01T22:20:02.284Z","url":"/api/media/file/13-pairing-code.webp","thumbnailURL":"/api/media/file/13-pairing-code-300x178.webp","filename":"13-pairing-code.webp","mimeType":"image/webp","filesize":41502,"width":1969,"height":1167,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/13-pairing-code-300x178.webp","width":300,"height":178,"mimeType":"image/webp","filesize":3514,"filename":"13-pairing-code-300x178.webp"},"square":{"url":"/api/media/file/13-pairing-code-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":12356,"filename":"13-pairing-code-500x500.webp"},"small":{"url":"/api/media/file/13-pairing-code-600x356.webp","width":600,"height":356,"mimeType":"image/webp","filesize":9396,"filename":"13-pairing-code-600x356.webp"},"medium":{"url":"/api/media/file/13-pairing-code-900x533.webp","width":900,"height":533,"mimeType":"image/webp","filesize":16228,"filename":"13-pairing-code-900x533.webp"},"large":{"url":"/api/media/file/13-pairing-code-1400x830.webp","width":1400,"height":830,"mimeType":"image/webp","filesize":27850,"filename":"13-pairing-code-1400x830.webp"},"xlarge":{"url":"/api/media/file/13-pairing-code-1920x1138.webp","width":1920,"height":1138,"mimeType":"image/webp","filesize":40988,"filename":"13-pairing-code-1920x1138.webp"},"og":{"url":"/api/media/file/13-pairing-code-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":21914,"filename":"13-pairing-code-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"When it works, Builderlab confirms your identity is connected. You will see your Nostr ID and the option to create a community.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":54,"alt":"Builderlab dashboard confirming the Buzz identity is connected","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 7c — Identity linked. Your Nostr ID now appears.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:05.979Z","createdAt":"2026-08-01T22:20:04.610Z","url":"/api/media/file/14-identity-connected.webp","thumbnailURL":"/api/media/file/14-identity-connected-300x216.webp","filename":"14-identity-connected.webp","mimeType":"image/webp","filesize":33148,"width":1673,"height":1205,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/14-identity-connected-300x216.webp","width":300,"height":216,"mimeType":"image/webp","filesize":3052,"filename":"14-identity-connected-300x216.webp"},"square":{"url":"/api/media/file/14-identity-connected-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":7930,"filename":"14-identity-connected-500x500.webp"},"small":{"url":"/api/media/file/14-identity-connected-600x432.webp","width":600,"height":432,"mimeType":"image/webp","filesize":8824,"filename":"14-identity-connected-600x432.webp"},"medium":{"url":"/api/media/file/14-identity-connected-900x648.webp","width":900,"height":648,"mimeType":"image/webp","filesize":14778,"filename":"14-identity-connected-900x648.webp"},"large":{"url":"/api/media/file/14-identity-connected-1400x1008.webp","width":1400,"height":1008,"mimeType":"image/webp","filesize":26402,"filename":"14-identity-connected-1400x1008.webp"},"xlarge":{"url":null,"width":null,"height":null,"mimeType":null,"filesize":null,"filename":null},"og":{"url":"/api/media/file/14-identity-connected-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":20206,"filename":"14-identity-connected-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 8 — Name and create your community","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Create Community","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" and pick a short, readable name. That name becomes part of your community address, so it is worth a moment's thought: a name like ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"spidev","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" produces an address such as ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"spidev.communities.buzz.xyz","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":55,"alt":"Builderlab form for naming a new Buzz community","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 8 — The name becomes part of the permanent address. Choose it deliberately.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:08.250Z","createdAt":"2026-08-01T22:20:06.593Z","url":"/api/media/file/15-name-community.png","thumbnailURL":"/api/media/file/15-name-community-300x132.png","filename":"15-name-community.png","mimeType":"image/png","filesize":208360,"width":1972,"height":866,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/15-name-community-300x132.png","width":300,"height":132,"mimeType":"image/png","filesize":11734,"filename":"15-name-community-300x132.png"},"square":{"url":"/api/media/file/15-name-community-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":22215,"filename":"15-name-community-500x500.png"},"small":{"url":"/api/media/file/15-name-community-600x263.png","width":600,"height":263,"mimeType":"image/png","filesize":30463,"filename":"15-name-community-600x263.png"},"medium":{"url":"/api/media/file/15-name-community-900x395.png","width":900,"height":395,"mimeType":"image/png","filesize":52883,"filename":"15-name-community-900x395.png"},"large":{"url":"/api/media/file/15-name-community-1400x615.png","width":1400,"height":615,"mimeType":"image/png","filesize":132649,"filename":"15-name-community-1400x615.png"},"xlarge":{"url":"/api/media/file/15-name-community-1920x843.png","width":1920,"height":843,"mimeType":"image/png","filesize":157162,"filename":"15-name-community-1920x843.png"},"og":{"url":"/api/media/file/15-name-community-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":95344,"filename":"15-name-community-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"After ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Create","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", the community appears in the Builderlab dashboard. From there you can copy its address or click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Open in Buzz","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":56,"alt":"Builderlab dashboard showing a created community","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 8b — Community ready. From here it opens in the app.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:10.241Z","createdAt":"2026-08-01T22:20:08.855Z","url":"/api/media/file/16-community-created.png","thumbnailURL":"/api/media/file/16-community-created-300x81.png","filename":"16-community-created.png","mimeType":"image/png","filesize":134170,"width":1948,"height":524,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/16-community-created-300x81.png","width":300,"height":81,"mimeType":"image/png","filesize":9132,"filename":"16-community-created-300x81.png"},"square":{"url":"/api/media/file/16-community-created-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":19086,"filename":"16-community-created-500x500.png"},"small":{"url":"/api/media/file/16-community-created-600x161.png","width":600,"height":161,"mimeType":"image/png","filesize":21372,"filename":"16-community-created-600x161.png"},"medium":{"url":"/api/media/file/16-community-created-900x242.png","width":900,"height":242,"mimeType":"image/png","filesize":40870,"filename":"16-community-created-900x242.png"},"large":{"url":"/api/media/file/16-community-created-1400x377.png","width":1400,"height":377,"mimeType":"image/png","filesize":87837,"filename":"16-community-created-1400x377.png"},"xlarge":{"url":"/api/media/file/16-community-created-1920x516.png","width":1920,"height":516,"mimeType":"image/png","filesize":111600,"filename":"16-community-created-1920x516.png"},"og":{"url":"/api/media/file/16-community-created-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":43736,"filename":"16-community-created-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 9 — Let Buzz join the community","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Open in Buzz","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". The desktop app shows a brief screen while it connects securely.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Wait for it to finish. You do not need to type the address by hand unless the automatic hand-off fails.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":57,"alt":"Buzz screen connecting securely to the new community","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 9 — The automatic hand-off saves you typing the address by hand.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:12.652Z","createdAt":"2026-08-01T22:20:11.297Z","url":"/api/media/file/17-joining-community.webp","thumbnailURL":"/api/media/file/17-joining-community-300x195.webp","filename":"17-joining-community.webp","mimeType":"image/webp","filesize":22098,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/17-joining-community-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":1286,"filename":"17-joining-community-300x195.webp"},"square":{"url":"/api/media/file/17-joining-community-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":4148,"filename":"17-joining-community-500x500.webp"},"small":{"url":"/api/media/file/17-joining-community-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":3406,"filename":"17-joining-community-600x389.webp"},"medium":{"url":"/api/media/file/17-joining-community-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":6254,"filename":"17-joining-community-900x584.webp"},"large":{"url":"/api/media/file/17-joining-community-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":14738,"filename":"17-joining-community-1400x908.webp"},"xlarge":{"url":"/api/media/file/17-joining-community-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":22604,"filename":"17-joining-community-1920x1246.webp"},"og":{"url":"/api/media/file/17-joining-community-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":9860,"filename":"17-joining-community-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 10 — Build your profile","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz asks for a username and, optionally, an avatar. This is how you appear in messages, reactions and agent hand-offs.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Use a name your team will recognise. The profile can be refined later.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":58,"alt":"Buzz profile setup screen with the username field","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 10 — This is the name your teammates and your agents will see.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:15.073Z","createdAt":"2026-08-01T22:20:13.706Z","url":"/api/media/file/18-profile-setup.webp","thumbnailURL":"/api/media/file/18-profile-setup-300x195.webp","filename":"18-profile-setup.webp","mimeType":"image/webp","filesize":27162,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/18-profile-setup-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":1658,"filename":"18-profile-setup-300x195.webp"},"square":{"url":"/api/media/file/18-profile-setup-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":5690,"filename":"18-profile-setup-500x500.webp"},"small":{"url":"/api/media/file/18-profile-setup-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":4814,"filename":"18-profile-setup-600x389.webp"},"medium":{"url":"/api/media/file/18-profile-setup-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":8380,"filename":"18-profile-setup-900x584.webp"},"large":{"url":"/api/media/file/18-profile-setup-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":17742,"filename":"18-profile-setup-1400x908.webp"},"xlarge":{"url":"/api/media/file/18-profile-setup-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":26870,"filename":"18-profile-setup-1920x1246.webp"},"og":{"url":"/api/media/file/18-profile-setup-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":11604,"filename":"18-profile-setup-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 11 — Meet the starter team","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz creates three starter agents: ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Fizz","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":", ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Honey","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" and ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Bumble","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". They exist so you can understand the workspace and test basic agent collaboration without configuring anything.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Click ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Take me to Buzz","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":59,"alt":"Buzz starter team screen showing Fizz, Honey and Bumble","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 11 — Three starter agents so you can learn without configuring anything.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:17.544Z","createdAt":"2026-08-01T22:20:16.175Z","url":"/api/media/file/19-starter-agents.webp","thumbnailURL":"/api/media/file/19-starter-agents-300x195.webp","filename":"19-starter-agents.webp","mimeType":"image/webp","filesize":38176,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/19-starter-agents-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":2730,"filename":"19-starter-agents-300x195.webp"},"square":{"url":"/api/media/file/19-starter-agents-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":9806,"filename":"19-starter-agents-500x500.webp"},"small":{"url":"/api/media/file/19-starter-agents-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":7562,"filename":"19-starter-agents-600x389.webp"},"medium":{"url":"/api/media/file/19-starter-agents-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":13250,"filename":"19-starter-agents-900x584.webp"},"large":{"url":"/api/media/file/19-starter-agents-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":26126,"filename":"19-starter-agents-1400x908.webp"},"xlarge":{"url":"/api/media/file/19-starter-agents-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":38480,"filename":"19-starter-agents-1920x1246.webp"},"og":{"url":"/api/media/file/19-starter-agents-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":18750,"filename":"19-starter-agents-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 12 — Send your first message","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"You are in. The left sidebar holds Inbox, Agents and your channels. The private ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"#Welcome","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":" channel is a good starting point.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Fizz posts the first message. You can reply, mention an agent with ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"@","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":", create a new channel, or create another agent. Start with something small and verifiable: draft an article outline, research a tool, summarise a document.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":60,"alt":"Buzz welcome channel with starter agent Fizz and quick actions","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Step 12 — You are in. The #Welcome channel is the best place for a first task.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:19.998Z","createdAt":"2026-08-01T22:20:18.571Z","url":"/api/media/file/20-welcome-channel.webp","thumbnailURL":"/api/media/file/20-welcome-channel-300x195.webp","filename":"20-welcome-channel.webp","mimeType":"image/webp","filesize":51438,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/20-welcome-channel-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":2946,"filename":"20-welcome-channel-300x195.webp"},"square":{"url":"/api/media/file/20-welcome-channel-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":10476,"filename":"20-welcome-channel-500x500.webp"},"small":{"url":"/api/media/file/20-welcome-channel-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":9854,"filename":"20-welcome-channel-600x389.webp"},"medium":{"url":"/api/media/file/20-welcome-channel-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":18368,"filename":"20-welcome-channel-900x584.webp"},"large":{"url":"/api/media/file/20-welcome-channel-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":33408,"filename":"20-welcome-channel-1400x908.webp"},"xlarge":{"url":"/api/media/file/20-welcome-channel-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":50958,"filename":"20-welcome-channel-1920x1246.webp"},"og":{"url":"/api/media/file/20-welcome-channel-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":25428,"filename":"20-welcome-channel-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Configuring an agent once the workspace runs","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"You do not need to understand every setting on day one. Open ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Agents","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" in the sidebar and select one of the starter agents.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The edit screen lets you choose who can talk to the agent, which runtime it uses, and which model provider powers it. On our install the menu included Anthropic, OpenAI, OpenAI-compatible services, Buzz shared compute, and Databricks options.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":61,"alt":"Buzz agent edit screen with the LLM provider menu open","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The model provider is chosen per agent: Anthropic, OpenAI, compatible services, shared compute or Databricks.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:22.357Z","createdAt":"2026-08-01T22:20:20.686Z","url":"/api/media/file/21-llm-provider.png","thumbnailURL":"/api/media/file/21-llm-provider-300x286.png","filename":"21-llm-provider.png","mimeType":"image/png","filesize":259927,"width":1478,"height":1408,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/21-llm-provider-300x286.png","width":300,"height":286,"mimeType":"image/png","filesize":24415,"filename":"21-llm-provider-300x286.png"},"square":{"url":"/api/media/file/21-llm-provider-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":56457,"filename":"21-llm-provider-500x500.png"},"small":{"url":"/api/media/file/21-llm-provider-600x572.png","width":600,"height":572,"mimeType":"image/png","filesize":70635,"filename":"21-llm-provider-600x572.png"},"medium":{"url":"/api/media/file/21-llm-provider-900x857.png","width":900,"height":857,"mimeType":"image/png","filesize":132569,"filename":"21-llm-provider-900x857.png"},"large":{"url":"/api/media/file/21-llm-provider-1400x1334.png","width":1400,"height":1334,"mimeType":"image/png","filesize":272992,"filename":"21-llm-provider-1400x1334.png"},"xlarge":{"url":null,"width":null,"height":null,"mimeType":null,"filesize":null,"filename":null},"og":{"url":"/api/media/file/21-llm-provider-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":139299,"filename":"21-llm-provider-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The Agents page works as a control centre: you see each agent's card, add a new one, check which model is selected, and stop any that are running.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":62,"alt":"Buzz Agents page showing Fizz, Honey, Bumble and a new-agent card","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The Agents page doubles as a control centre: create, check the model, or stop one.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:24.876Z","createdAt":"2026-08-01T22:20:23.405Z","url":"/api/media/file/22-agents-page.webp","thumbnailURL":"/api/media/file/22-agents-page-300x195.webp","filename":"22-agents-page.webp","mimeType":"image/webp","filesize":45478,"width":2048,"height":1329,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/22-agents-page-300x195.webp","width":300,"height":195,"mimeType":"image/webp","filesize":3320,"filename":"22-agents-page-300x195.webp"},"square":{"url":"/api/media/file/22-agents-page-500x500.webp","width":500,"height":500,"mimeType":"image/webp","filesize":9134,"filename":"22-agents-page-500x500.webp"},"small":{"url":"/api/media/file/22-agents-page-600x389.webp","width":600,"height":389,"mimeType":"image/webp","filesize":9296,"filename":"22-agents-page-600x389.webp"},"medium":{"url":"/api/media/file/22-agents-page-900x584.webp","width":900,"height":584,"mimeType":"image/webp","filesize":16694,"filename":"22-agents-page-900x584.webp"},"large":{"url":"/api/media/file/22-agents-page-1400x908.webp","width":1400,"height":908,"mimeType":"image/webp","filesize":29528,"filename":"22-agents-page-1400x908.webp"},"xlarge":{"url":"/api/media/file/22-agents-page-1920x1246.webp","width":1920,"height":1246,"mimeType":"image/webp","filesize":43424,"filename":"22-agents-page-1920x1246.webp"},"og":{"url":"/api/media/file/22-agents-page-1200x630.webp","width":1200,"height":630,"mimeType":"image/webp","filesize":22058,"filename":"22-agents-page-1200x630.webp"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Each agent also has its own profile, with a public key, runtime status, connected channels, memory count and who manages it. That profile is the clearest illustration of the difference between Buzz and a conventional chatbot: the agent has an identity inside the workspace, and that identity leaves a trail.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":63,"alt":"Buzz agent profile for Honey showing public key, channels and manager","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Every agent has a public key, channels and a manager. This is where Buzz stops resembling a chatbot.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:26.890Z","createdAt":"2026-08-01T22:20:25.429Z","url":"/api/media/file/23-agent-profile.png","thumbnailURL":"/api/media/file/23-agent-profile-300x382.png","filename":"23-agent-profile.png","mimeType":"image/png","filesize":105503,"width":736,"height":936,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/23-agent-profile-300x382.png","width":300,"height":382,"mimeType":"image/png","filesize":31011,"filename":"23-agent-profile-300x382.png"},"square":{"url":"/api/media/file/23-agent-profile-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":58503,"filename":"23-agent-profile-500x500.png"},"small":{"url":"/api/media/file/23-agent-profile-600x763.png","width":600,"height":763,"mimeType":"image/png","filesize":85478,"filename":"23-agent-profile-600x763.png"},"medium":{"url":null,"width":null,"height":null,"mimeType":null,"filesize":null,"filename":null},"large":{"url":null,"width":null,"height":null,"mimeType":null,"filesize":null,"filename":null},"xlarge":{"url":null,"width":null,"height":null,"mimeType":null,"filesize":null,"filename":null},"og":{"url":"/api/media/file/23-agent-profile-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":89292,"filename":"23-agent-profile-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Advanced features worth knowing about","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"upload","value":{"id":73,"alt":"Cards showing three advanced Buzz capabilities: Experiments, shared compute and the Chief Agent Officer pattern","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What is worth switching on once the basic workspace already works.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:50.640Z","createdAt":"2026-08-01T22:20:48.867Z","url":"/api/media/file/advanced.en.png","thumbnailURL":"/api/media/file/advanced.en-300x161.png","filename":"advanced.en.png","mimeType":"image/png","filesize":127259,"width":3200,"height":1720,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/advanced.en-300x161.png","width":300,"height":161,"mimeType":"image/png","filesize":23021,"filename":"advanced.en-300x161.png"},"square":{"url":"/api/media/file/advanced.en-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":71885,"filename":"advanced.en-500x500.png"},"small":{"url":"/api/media/file/advanced.en-600x323.png","width":600,"height":323,"mimeType":"image/png","filesize":66582,"filename":"advanced.en-600x323.png"},"medium":{"url":"/api/media/file/advanced.en-900x484.png","width":900,"height":484,"mimeType":"image/png","filesize":125637,"filename":"advanced.en-900x484.png"},"large":{"url":"/api/media/file/advanced.en-1400x753.png","width":1400,"height":753,"mimeType":"image/png","filesize":232156,"filename":"advanced.en-1400x753.png"},"xlarge":{"url":"/api/media/file/advanced.en-1920x1032.png","width":1920,"height":1032,"mimeType":"image/png","filesize":341090,"filename":"advanced.en-1920x1032.png"},"og":{"url":"/api/media/file/advanced.en-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":177093,"filename":"advanced.en-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Once the basics feel comfortable, Buzz holds several capabilities that genuinely change how a team works. All of them are optional.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The Experiments panel","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz hides features behind an experiments panel until you are ready. They are enabled in ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Settings → Experiments","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":64,"alt":"The Experiments panel in Buzz settings","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Settings → Experiments. Turn them on one at a time.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:29.884Z","createdAt":"2026-08-01T22:20:27.788Z","url":"/api/media/file/25-experiments-panel.png","thumbnailURL":"/api/media/file/25-experiments-panel-300x153.png","filename":"25-experiments-panel.png","mimeType":"image/png","filesize":461236,"width":2624,"height":1336,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/25-experiments-panel-300x153.png","width":300,"height":153,"mimeType":"image/png","filesize":17651,"filename":"25-experiments-panel-300x153.png"},"square":{"url":"/api/media/file/25-experiments-panel-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":42913,"filename":"25-experiments-panel-500x500.png"},"small":{"url":"/api/media/file/25-experiments-panel-600x305.png","width":600,"height":305,"mimeType":"image/png","filesize":54171,"filename":"25-experiments-panel-600x305.png"},"medium":{"url":"/api/media/file/25-experiments-panel-900x458.png","width":900,"height":458,"mimeType":"image/png","filesize":104919,"filename":"25-experiments-panel-900x458.png"},"large":{"url":"/api/media/file/25-experiments-panel-1400x713.png","width":1400,"height":713,"mimeType":"image/png","filesize":229706,"filename":"25-experiments-panel-1400x713.png"},"xlarge":{"url":"/api/media/file/25-experiments-panel-1920x978.png","width":1920,"height":978,"mimeType":"image/png","filesize":463727,"filename":"25-experiments-panel-1920x978.png"},"og":{"url":"/api/media/file/25-experiments-panel-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":168377,"filename":"25-experiments-panel-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The main ones:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Workflows","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — automations defined in YAML with approval gates. For example, a daily flow that pulls API data into a channel, or runs the test suite when code changes.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Projects","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — browse and collaborate on Git repositories inside Buzz. Code review, pull requests and CI status appear in the same event log as the conversation about that code.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Pulse","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — an activity feed that gathers notes, posts and agent activity in one place.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Forum Channels","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — threaded, forum-style channels separate from the main chat, for long-form discussion.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Agent-managed profiles","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — let each agent manage its own relay name and avatar instead of copying them from your settings.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"They work, but they are still being refined. Turn one or two on and add more as you get comfortable.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Shared compute: bringing the team's costs down","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This is one of Buzz's most distinctive features. It lets you share your machine's computing power with the team, so everyone runs agents on one strong computer instead of paying for expensive API plans.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":65,"alt":"Shared compute settings in Buzz","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Settings → Compute. Sharing the machine turns one strong computer into team infrastructure.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:32.372Z","createdAt":"2026-08-01T22:20:30.711Z","url":"/api/media/file/26-shared-compute.png","thumbnailURL":"/api/media/file/26-shared-compute-300x130.png","filename":"26-shared-compute.png","mimeType":"image/png","filesize":483038,"width":2704,"height":1168,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/26-shared-compute-300x130.png","width":300,"height":130,"mimeType":"image/png","filesize":18926,"filename":"26-shared-compute-300x130.png"},"square":{"url":"/api/media/file/26-shared-compute-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":73034,"filename":"26-shared-compute-500x500.png"},"small":{"url":"/api/media/file/26-shared-compute-600x259.png","width":600,"height":259,"mimeType":"image/png","filesize":56762,"filename":"26-shared-compute-600x259.png"},"medium":{"url":"/api/media/file/26-shared-compute-900x389.png","width":900,"height":389,"mimeType":"image/png","filesize":109252,"filename":"26-shared-compute-900x389.png"},"large":{"url":"/api/media/file/26-shared-compute-1400x605.png","width":1400,"height":605,"mimeType":"image/png","filesize":238123,"filename":"26-shared-compute-1400x605.png"},"xlarge":{"url":"/api/media/file/26-shared-compute-1920x829.png","width":1920,"height":829,"mimeType":"image/png","filesize":456182,"filename":"26-shared-compute-1920x829.png"},"og":{"url":"/api/media/file/26-shared-compute-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":174387,"filename":"26-shared-compute-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"It works like this: in ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Settings → Compute","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" you enable ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Share this machine with your relay","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". Buzz suggests local models optimised for your hardware and, once you download one and enable sharing, any member of your relay can run agents on your machine.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"For small teams this changes the cost equation. A collaborator on a limited budget joins the team and everyone draws on a single Mac Studio or Mac Mini, without each person paying for API subscriptions. And because local models keep improving, the option gets more reasonable against proprietary APIs every month.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Swapping models without losing context","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"You can change the model powering an agent without losing anything. If you have been working with an agent on Claude and move it to Codex or a local model, the history, the project context and the agent's skills travel with it.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"This matters more than it seems. New models ship every week; instead of being locked to one, you can experiment and adapt without starting over.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Workflows teams are already running","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Deploy an app inside a conversation","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — you ask an agent to build an application and deploy it. The agent writes the code, pushes it to a repository, ships it, and returns screenshots to the chat. You review the live app and request changes.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Analyse data with historical context","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — you set up a daily flow that pulls metrics into a channel. Because the agent has the history it posted itself, it can find patterns and give you actionable readings.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Work in parallel","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — you ask for three different landing page versions based on what was discussed in chat. The agents work in separate branches without overwriting each other.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Voice calls with context","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" — you start a live call with an agent, speak to it, it answers in voice, and it keeps the full context of the written conversation.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The \"Chief Agent Officer\" pattern","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"As your roster of agents grows, choosing which one to use becomes a burden. Instead of managing each individually, create a meta-agent — a \"Chief Agent Officer\" — that takes the brief and delegates to the specialists: writer, developer, reviewer. It cuts decision fatigue and lets the system scale.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h3","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Where did my files go?","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"One question always comes up: how to see or touch the files the agents are working on.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"In Buzz, agents work in ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"work trees","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":". When you ask an agent to write code or create a file, it does not overwrite your local documents: it creates a separate branch or version of the project. To see them:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ol","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Enable the ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"Projects","type":"text","style":"","detail":0,"format":1,"version":1},{"mode":"normal","text":" experiment in Settings.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Use the Git repository browser inside Buzz to view the branches.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Check out or download the files once you are happy with the result.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"number","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Locally, agent-created files live in ","type":"text","style":"","detail":0,"format":0,"version":1},{"mode":"normal","text":"~/.buzz","type":"text","style":"","detail":0,"format":16,"version":1},{"mode":"normal","text":". The scheme keeps your main files safe, but it adds a step that feels clumsy if you only wanted a quick export.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The three terms that confuse people at first","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Setup is straightforward once you understand the order. What stalls most people is three words.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"upload","value":{"id":75,"alt":"Table explaining the terms Nostr, relay and harness with an analogy for each","caption":{"root":{"type":"root","format":"","indent":0,"version":1,"children":[{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Three words that stall almost everyone in the first hour.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"direction":"ltr"}},"folder":null,"updatedAt":"2026-08-01T22:20:55.266Z","createdAt":"2026-08-01T22:20:53.542Z","url":"/api/media/file/glossary.en.png","thumbnailURL":"/api/media/file/glossary.en-300x131.png","filename":"glossary.en.png","mimeType":"image/png","filesize":133733,"width":3200,"height":1400,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/glossary.en-300x131.png","width":300,"height":131,"mimeType":"image/png","filesize":17891,"filename":"glossary.en-300x131.png"},"square":{"url":"/api/media/file/glossary.en-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":75359,"filename":"glossary.en-500x500.png"},"small":{"url":"/api/media/file/glossary.en-600x263.png","width":600,"height":263,"mimeType":"image/png","filesize":53555,"filename":"glossary.en-600x263.png"},"medium":{"url":"/api/media/file/glossary.en-900x394.png","width":900,"height":394,"mimeType":"image/png","filesize":98605,"filename":"glossary.en-900x394.png"},"large":{"url":"/api/media/file/glossary.en-1400x613.png","width":1400,"height":613,"mimeType":"image/png","filesize":186282,"filename":"glossary.en-1400x613.png"},"xlarge":{"url":"/api/media/file/glossary.en-1920x840.png","width":1920,"height":840,"mimeType":"image/png","filesize":289538,"filename":"glossary.en-1920x840.png"},"og":{"url":"/api/media/file/glossary.en-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":163322,"filename":"glossary.en-1200x630.png"}}},"fields":null,"format":"","version":3,"relationTo":"media"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The other friction point is the agent harness screen. Ignore it on the first pass if you are not already using Claude Code or Codex: build the community first and add the harness when you have a concrete reason.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Honest limitations and early-stage reality","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Buzz is new and still changing. It is worth being clear about what to expect:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ul","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Workflows and recurring tasks are still rough. The feature exists but reliability is not perfect — test them with non-critical work first.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Speed lags behind direct CLIs like Claude Code or Codex. Everything routes through the relay and back, which adds latency.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"For complex software engineering you will probably still prefer command-line tools. For team and agent coordination, Buzz is faster.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":4,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Voice calls exist but are not thoroughly tested in production.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":5,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The sweet spot today is small teams and independent operators iterating on focused products. For large-scale operations you will need additional tooling.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"bullet","direction":"ltr"},{"tag":"h2","type":"heading","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"What this means for your team","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Whether or not you adopt Buzz this week, the product previews a shift we are already seeing in the projects we deploy: agents stop being a separate chat box and become participants with identity, permissions and traceability inside the real workflow.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"That is the part worth copying even if you use a different tool. Three questions that apply to any stack:","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"tag":"ol","type":"list","start":1,"format":"","indent":0,"version":1,"children":[{"type":"listitem","value":1,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Does each agent have a distinguishable identity, or does the whole team share one generic API key?","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":2,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Is there a record of what each agent did, reviewable afterwards by a person?","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"type":"listitem","value":3,"format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"Can you swap models without losing the context you have accumulated?","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"}],"listType":"number","direction":"ltr"},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"If the answer to any of those is \"no\", that is your next improvement — with Buzz or without it. If you want to see what that looks like applied to your operation, ","type":"text","style":"","detail":0,"format":0,"version":1},{"type":"link","fields":{"url":"/en/start","newTab":false,"linkType":"custom"},"format":"","indent":0,"version":3,"children":[{"mode":"normal","text":"tell us what you are building","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr"},{"mode":"normal","text":".","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0},{"type":"horizontalrule","version":1},{"type":"paragraph","format":"","indent":0,"version":1,"children":[{"mode":"normal","text":"The screenshots in this guide come from setting up a Buzz community in August 2026. Screens and available options may change as the product evolves.","type":"text","style":"","detail":0,"format":0,"version":1}],"direction":"ltr","textStyle":"","textFormat":0}],"direction":"ltr"}},"faqs":[{"question":"What is Buzz.xyz?","answer":"Buzz is an open-source workspace built by Block, Jack Dorsey's company, where people and AI agents collaborate in the same channels. It runs on Nostr, a protocol that uses cryptographic keys as identity, so every agent has its own identity, permissions and audit trail.","id":"6a6e714be688831bcfc06750"},{"question":"Is Buzz.xyz free?","answer":"The app is open source and Block's hosted relay costs nothing, so you can start without paying. If you prefer to host your own relay to control the data, expect $5–50 per month depending on team size. Separately, each agent consumes whichever model you assign it, at that provider's cost.","id":"6a6e714be688831bcfc06751"},{"question":"What is a relay in Buzz, and why does it matter?","answer":"The relay is the server that stores your community's messages, identities and work trail — in practice, your team's hard drive. It matters because it determines who owns the data. You can use Block's hosted relay or run your own on Railway, DigitalOcean or AWS.","id":"6a6e714be688831bcfc06752"},{"question":"What happens if I lose my Buzz private key?","answer":"There is no recovery. The private key is your identity and no reset process exists, so anyone holding it can act as you. Store it in a password manager the moment Buzz generates it; the operating system keychain does not count as a backup.","id":"6a6e714be688831bcfc06753"},{"question":"How long does the Buzz.xyz setup take?","answer":"Between 15 and 25 minutes if you follow the steps in order and already have access to your inbox to verify it. The three points where most people stall are understanding the relay, saving the private key, and the agent harness screen — which you can skip on the first pass.","id":"6a6e714be688831bcfc06754"},{"question":"Can I use Claude or GPT inside Buzz?","answer":"Yes. The model provider is configured per agent and includes Anthropic, OpenAI, OpenAI-compatible services, Buzz shared compute and Databricks options. You can also switch an agent's model without losing its history or the project context.","id":"6a6e714be688831bcfc06755"}],"relatedPosts":[],"categories":[{"id":1,"title":"AI agents","generateSlug":false,"slug":"agentes-de-ia","parent":null,"breadcrumbs":[{"doc":1,"url":"/agentes-de-ia","label":"AI agents","id":"6a6e6d2914168f5572e8e0b2"}],"updatedAt":"2026-08-01T22:20:55.875Z","createdAt":"2026-08-01T22:03:19.833Z"}],"meta":{"title":"How to set up Buzz.xyz step by step (2026 guide) | Spidev","image":{"id":43,"alt":"Buzz.xyz home page: \"Where people and agents work together\"","caption":null,"folder":null,"updatedAt":"2026-08-01T22:19:38.828Z","createdAt":"2026-08-01T22:19:36.783Z","url":"/api/media/file/00-hero.png","thumbnailURL":"/api/media/file/00-hero-300x169.png","filename":"00-hero.png","mimeType":"image/png","filesize":371897,"width":1920,"height":1080,"focalX":50,"focalY":50,"sizes":{"thumbnail":{"url":"/api/media/file/00-hero-300x169.png","width":300,"height":169,"mimeType":"image/png","filesize":14588,"filename":"00-hero-300x169.png"},"square":{"url":"/api/media/file/00-hero-500x500.png","width":500,"height":500,"mimeType":"image/png","filesize":60067,"filename":"00-hero-500x500.png"},"small":{"url":"/api/media/file/00-hero-600x338.png","width":600,"height":338,"mimeType":"image/png","filesize":54003,"filename":"00-hero-600x338.png"},"medium":{"url":"/api/media/file/00-hero-900x506.png","width":900,"height":506,"mimeType":"image/png","filesize":110539,"filename":"00-hero-900x506.png"},"large":{"url":"/api/media/file/00-hero-1400x788.png","width":1400,"height":788,"mimeType":"image/png","filesize":243322,"filename":"00-hero-1400x788.png"},"xlarge":{"url":"/api/media/file/00-hero-1920x1080.png","width":1920,"height":1080,"mimeType":"image/png","filesize":345280,"filename":"00-hero-1920x1080.png"},"og":{"url":"/api/media/file/00-hero-1200x630.png","width":1200,"height":630,"mimeType":"image/png","filesize":180651,"filename":"00-hero-1200x630.png"}}},"description":"Complete guide to installing Buzz.xyz, Jack Dorsey's decentralised workspace: identity key, relay, community, and your first team of AI agents."},"publishedAt":"2026-08-01T15:00:00.000Z","readingTime":12,"authors":[1],"populatedAuthors":[{"id":1,"name":"shadow"}],"generateSlug":false,"slug":"buzz-xyz-setup-guide-ai-agent-workspace","updatedAt":"2026-08-01T22:20:59.770Z","createdAt":"2026-08-01T22:03:21.803Z","_status":"published"}],"hasNextPage":false,"hasPrevPage":false,"limit":10,"nextPage":null,"page":1,"pagingCounter":1,"prevPage":null,"totalDocs":3,"totalPages":1}