Citadel is a Windows app that helps you run agent workflows with Claude Code. It keeps your work in one place, lets you move through tasks in stages, and helps you pick up where you left off. It is built for people who want a clear way to manage repeated work without setting up a complex system.
- Windows 10 or Windows 11
- An internet connection for the first download
- Enough free disk space for the app and its workspace files
- Claude Code access if you plan to use the agent features
- A standard user account is enough for most setups
Use this link to visit the download page and get the app:
Visit the Citadel download page
When the page opens, look for the latest release or the main download option. If you see a setup file, download it to your PC. If the app comes as a zip file, save it and extract it first.
- Open the downloaded file.
- If Windows asks for permission, select Yes.
- If you downloaded a zip file, right-click it and choose Extract All.
- Open the extracted folder.
- Double-click the Citadel app or setup file.
- Follow the on-screen steps to finish the install.
After installation, start Citadel from your desktop or Start menu.
You may be asked to choose a workspace folder. This is where Citadel stores campaign data, logs, and task history. Pick a folder you can find again, such as Documents or a project folder on your drive.
If the app asks for Claude Code settings, enter the details you use for your Claude Code setup. Citadel uses that link to route work through its agent flow.
Citadel uses a simple flow so you can move from one step to the next without confusion.
- /do routing sends work into the right lane based on the task type
- Campaign persistence keeps your work saved across sessions
- Parallel agents handle separate tasks in isolated worktrees
- Discovery relay shares useful findings between waves of work
- Lifecycle hooks run checks at key points in the process
- Circuit breaker helps stop runaway tasks
- Skills give the app set patterns for common work
You do not need to manage each part by hand. Citadel handles the flow while you focus on the task you want done.
Citadel works well for:
- Repeated coding tasks
- Step-by-step agent work
- Grouped research and task planning
- Long tasks that need saving between sessions
- Work that must stay separated into safe branches
- Multi-wave task runs where each wave learns from the last
Once the app is open, use these steps to get started:
- Create or choose a workspace.
- Add your first campaign.
- Pick the task type you want to run.
- Start the workflow with the /do command or the app control that starts a run.
- Watch the task status as it moves through each stage.
If you plan to use more than one agent, Citadel will place them in separate worktrees. This helps keep each task clean and easier to manage.
- Use short task names
- Keep one campaign per goal
- Save each work session in the same workspace
- Check the discovery relay before starting a new wave
- Use the circuit breaker if a task starts to drift
- Review the output after each stage before you move on
Citadel includes six production-quality skills for common agent work:
- Task routing
- Campaign tracking
- Parallel execution
- Discovery sharing
- Run control
- Session recovery
These skills help the app stay organized when you switch between jobs or come back later.
Citadel keeps work in isolated folders so separate runs do not mix with each other. This helps reduce mistakes when you run more than one agent or return to a task later.
If you use version control, keep your Citadel workspace inside a folder that is easy to back up. This makes it simpler to restore your work if needed.
A simple folder layout works well:
Documents\CitadelDocuments\Citadel\CampaignsDocuments\Citadel\LogsDocuments\Citadel\Exports
This setup keeps your main files, history, and output in one place.
To run a task:
- Open Citadel.
- Choose a campaign.
- Enter your goal in plain language.
- Select the route or stage that fits the job.
- Start the run.
- Check the results when the wave finishes.
If the task needs more work, Citadel can carry the campaign into the next session.
Citadel can save:
- Campaign state
- Task history
- Wave results
- Relay notes
- Logs
- Workspace paths
- Hook results
This gives you a record of what happened and makes it easier to continue later.
- Make sure the download finished
- Try running the app as an administrator
- Check that Windows did not block the file
- Restart your PC and try again
- Open Citadel and look at the last used folder
- Search for a folder named Citadel in Documents or Downloads
- Check any location you chose during setup
- Review the task input for missing details
- Check whether the circuit breaker ended the run
- Start the task again with a smaller scope
- Make sure the workspace folder is writable
- Check free disk space
- Confirm that the app has access to the folder you selected
For the cleanest setup, keep Citadel in a stable folder and avoid moving it after you start using it. Use the same workspace each time so campaign data stays in one place.
If you use multiple campaigns, keep each one in its own subfolder. This makes it easier to find logs, outputs, and saved state later.
Citadel is made for agent work that needs structure. It gives you:
- Clear routing for each task
- Save points between sessions
- Safe parallel work in separate folders
- Shared findings between stages
- Controls that help prevent loops
- A small set of built-in skills for common jobs
This makes it easier to keep large or repeated work under control
Use this page to download and run Citadel on Windows:
After setup, your files may look like this:
Citadel.exeworkspacecampaignslogsexportsconfig
Open Citadel when you want to:
- Start a new agent run
- Continue an older campaign
- Split work into parallel branches
- Review what each wave found
- Keep long tasks organized
- Resume work after closing the app
- Open the app
- Pick a campaign
- Enter the task
- Run the first wave
- Review the relay notes
- Start the next wave if needed
- Save the final result