Global / Dual-Root init and team members creation

[tihomir-kit]

Hi,

A few questions if you don't mind. Then using squad init --global does it silently register the default location anywhere?

When I ran that command, it created the global team under C:\Users\tkit\AppData\Roaming\squad\ in my case.

Now, what I wanted to do is, to move the global team from that location to C:\Projects\mysquad\ because that's where I clone all the repos that I work on, so I don't want the global squad in some other semi-random location. Also, I want to persist my global squad on GitHub and C:\Users\tkit\AppData\Roaming\squad\ is sort of totally out of the way.

• Did I effectively convert the Global Squad to a Dual-Root squad by moving it to C:\Projects\mysquad\?
• Do I have to somehow "unregister" the global squad now that I've moved all the contents from C:\Users\tkit\AppData\Roaming\squad\ to C:\Projects\mysquad\?

And now questions regarding actual members creation:

• If an actual project like say C:\Projects\whatever\ already had a squad, but I want to replace it with this global (dual-root?) one, do I just update the config.json in C:\Projects\whatever\ and point it to C:\Projects\mysquad\?
• If both C:\Projects\whatever\ and C:\Projects\mysquad\ contain squad members, will then C:\Projects\whatever\ have a combination of all of these squad members at disposal? (I assume I shouldn't really mix and match like this)
• Should I then empty-out all the old agents from C:\Projects\whatever\?
• Do I need to remove anything else from C:\Projects\whatever\?
  • I don't want to lose the project state if that makes sense - like the phases that have already been implemented.
  • I just want to start using a global squad.
• If C:\Projects\mysquad\ has no existing agents, at what point do I create them, and how / from where exactly?
  • Do I run squad from C:\Projects\mysquad\ and go something like "well this is not an actual project, but just a global squad location and I want to set up a squad with the following members ..."
  • Do I run squad from an actual project like C:\Projects\whatever\ and go "add the following members" and then these squad members will get created in C:\Projects\mysquad\ ?
  • Does it even matter, and I can do it either way?

Sorry for the flurry of questions, but I feel like these details are all kind of unclear at this stage. Really appreciate the effort you're putting into this!

Thanks!

[bradygaster]

Great questions! Let me address each:

Global squad location: squad init --global stores the team under your user data directory (e.g., C:\Users\{user}\AppData\Roaming\squad\ on Windows). This is the default location and it's not registered in a central config — the CLI just knows to look there.

Moving the global team: Moving the directory isn't officially supported yet. The CLI looks for the global squad in that specific path. If you want a custom location, you'd need to use a repo-level squad instead.

Dual-root (global + repo): When both exist, the repo-level .squad/ takes precedence. The global squad acts as a fallback when there's no repo-level team. You can't currently merge them — it's one or the other per session.

Adding members: Use squad cast to add new members to an existing team. You can run it interactively and it'll walk you through adding roles.

This is an area we're actively improving. If you have specific workflows that aren't supported, please file issues and we'll prioritize.