Troubleshooting

Common questions

Most snags have a one-line fix, and the first one below covers the majority of them. Open the question that matches what you see.

01I installed it and nothing happened.

This is the common one, and it isn't broken. The plugin gives your machine the team; it doesn't make a place for them to work. Until a folder is a hub, every background hook stays quiet — which looks exactly like nothing. Open your business's folder and say set me up.

02I did that, and I still don’t see the team.

Quit Claude Code completely: Cmd-Q on Mac, or right-click the tray icon then Quit on Windows. Do not just close the window. Reopen it afterwards — the team only loads on a fresh start.

03Do I need to install it in every repo?

No. You install once per computer and the team appears in every project automatically. To tie a repo to your business, say set me up inside it — see Projects & code.

04The team doesn’t seem to know my business.

Then the Brain is empty — making a hub and onboarding a business are two different steps. Say set me up first if you haven't, then ask to be onboarded. Margo interviews you for about fifteen minutes and writes it into Brain/. You can top it up any time by just telling a teammate something true; it gets written down.

05Where is all of this actually stored?

In your hub folder, as plain markdown: Brain/ for what's true, Desk/ for what's in flight, Library/ for finished work. Open them in any editor. Back them up like any other folder — there is no copy anywhere else, which is the point, and also the risk.

06Is my business information sent anywhere?

No. It's a folder of files on your machine. There's no account and no Capsho server holding it. Teammates only reach a third-party tool if you connected that tool in Claude Code yourself.

07It edited a live file and I wanted a draft.

Work landing on a live file normally gets moved onto a draft copy first, and you're told so. The exceptions are deliberate: your memory folders and the files at your business root edit in place. The one that catches people — a site kept under Library/ is not protected, because Library is memory. Keep code under projects/.

08The wrong teammate keeps answering.

Name the one you want, or ask who handles this? Monty routes the work and naming a teammate directly always wins. You shouldn't have to learn the names though — if routing keeps missing, that's worth telling us about.

09Will it change my existing Claude Code settings?

CapshoHQ installs as a normal Claude Code plugin and defers to Claude Code's own permission system rather than adding a second one on top. Your own hooks, permissions, model and connected tools are yours.

10Does it work on Windows, Mac and Linux?

Yes, all three. On Windows the team writes PowerShell rather than bash and any helper scripts it makes are Node — that's handled for you, not something to configure.

11How do I update or remove it?

Update by running git pull in the folder you cloned, then restarting. Remove it by uninstalling the plugins through Claude Code and restarting; your business folder is left alone, and deleting that is your call. Full detail in Install & update.

Still stuck?

Email hi@capsho.com. Include your operating system and exactly what you typed, and we will get you sorted.