Courage HubA VS Code extension that shows your Courage hub as a pixel map you choose: an open-plan office staffed by people you know, or a stadium staffed by creatures. Each Claude terminal is one character, with a bubble saying what it's doing and a "!" when it needs you. Its sub-agents appear beside it as little kids, or as the creature's small form in the stadium. Hub tasks are listed under the map. Courage is a set of files and scripts that lets Claude Code act as your project manager: it plans tasks, hands them to specialist agents and asks you before anything important changes. A copy comes with this extension. Getting startedYou need Windows and Claude Code, which isn't part of the free Claude plan.
If you already have a Courage folder, set Courage Hub: Hub Path in Settings to it instead. The side panel lists every agent with what it was asked to do, plus colored sections: Building (orange) is what it's doing right now, Decisions (silver) quotes the choices it announced, You'd likely agree (green) lists the files it changed, and You might disagree (red) flags things like deleting files or pushing. These are best guesses from plain rules, not a judge. Red never stops anything by itself, but it has two buttons. Disagree stops the agent like pressing Esc, then tells it what you objected to and asks how to undo it. Anything that already ran has already happened, so it can't always stop in time. Agree clears the warning, or opens the terminal if Claude is waiting for your OK. It's read-only and makes no AI calls. TerminalsEach open Claude terminal in VS Code gets one character, which leaves when the terminal closes. Click + Agent to start one and choose its folder. You can jump to a terminal from its character. To close one, hover over its character and click the X above its right side, or use the x on its row in the side panel, then answer Yes. Add a job label in + Agent to name what an agent is for. The side panel shows how full each agent's memory is, and flags an agent
whose log has been quiet for 5 minutes mid-job. In Details you can send it a message. A message goes as soon as the agent's turn has finished, and waits until then if it's busy, because
pressing Enter during a permission prompt could approve a command. Terminals opened with + Agent also show permission prompts as
Needs you, using hooks in their own settings. Claude's main settings aren't changed. The folder you pick is marked as trusted in Claude's
Agents need Claude Code, which isn't part of the free Claude plan. When you start an agent, the extension asks Claude Code for its sign-in status. If Claude Code is missing, signed out, or may be on a free plan, a message says so and links to the install or plans page. The terminal still opens either way. Project foldersKeep your projects as folders inside one main folder, To delete a project, pick it in the Folder list and click Delete this folder. After you answer Yes, the folder, its records and Claude's logs for it go to the Recycle Bin. A folder a Claude terminal is still using can't be deleted until it's closed. What needs youClick the black bar at the top of the map to list every agent and hub task waiting on you, with a button to go to each one. Courage Hub also has its own icon in VS Code's left bar. It opens a short Team list: who needs you first, then who's working, then everyone else, plus hub tasks waiting on you. Click a row to go to that terminal or task. The icon's badge shows how many things need you, and Open office and + Agent are at the top. RecordsEach agent's work is saved as one Markdown file per session in a The side panel's Search tab searches every saved record as you type, for words, file names or commands. Results are grouped by folder, with starred folders first, and the buttons show only prompts (Asked), changed files (Changed), Decision or Red items. Open shows the record at that entry. The side panel goes on the left or right of the map, or can be hidden, from Maps. It has four small tabs above Parallel agents. Agents is the quick look at everyone, and Details has the whole story: exact commands and their results, exact file changes, and Claude's full messages. Click a colored section in Agents to jump to it in Details, and click an entry's colored highlight in Details to jump back. Long text is cut short, and everything updates as the agent works. Comparison lists the files an agent changed, with what's different from the last commit. Click the green section in Agents to go there. Open full view shows a file's old and new versions side by side in its own editor tab. The comparison covers everything since the last commit, so it can include changes the agent didn't make. Files changed by its sub-agents aren't listed. The Agent activity tab beside Terminal shows the same record with more room, in two views, All and Details. Click a section in All to jump to it in Details. If the side panel is hidden, the side panel's links open this tab instead. Record files not changed for 90 days go to the Recycle Bin. You can change that or turn it off under Settings. Folders are never recycled automatically, only with their Recycle button there, and starring a folder keeps its files too. Your teamIn the office, you give each place in your lineup a name and a look. A project keeps its person: a new terminal in a folder goes back to the same place and desk it had before, in whatever order you open them. A second terminal open in that folder takes the next free place. A terminal in a new folder also takes the next free place, and keeps it from then on. Characters walk in through the door when their terminal opens and back out when it closes. Click the pencil beside a name in the side panel to rename it. In the stadium, each new terminal gets a random creature that isn't already out. The stadium comes with its own original creatures. To use your own art, click Open sprites folder and add PNGs.
Each one becomes a creature named after its file, and together they replace the built-in ones. To give one a small form
for its sub-agents, add a Try it from sourceOpen this folder in VS Code and press F5, or run this from the folder: Then click Courage Hub in the status bar, click its icon in the left bar, or run Courage Hub: Open Office from the Command Palette. The office opens in its own Courage Hub tab in the bottom panel, next to Terminal. For a bigger map, run Courage Hub: Open Office in a Tab, or set Courage Hub: Office In to Install fileTo build an install file, run this. It makes Install it from VS Code's Extensions view: click ..., then Install from VSIX.... To run the test walkthrough against that install instead of this folder, set TestsNo install step: the extension has no dependencies.
To check the whole extension in real VS Code with real Claude, run this. It's the test checklist in To check Set Up Courage the same way, run Your own art stays yoursYour own images and team choices stay on your own computer and out of Git. Never add someone else's art to the repo or a published package. |