Colony

Cria equipas de agentes de IA que trabalham juntos — directamente na tua IDE.

Colony é um framework de orquestração multi-agente. Descreves o que precisas em linguagem natural, o Arquitecto cria uma equipa de agentes especializados, e eles executam o trabalho automaticamente — passo a passo, com a tua aprovação nos momentos certos.

O que é um Squad?

Um squad é uma equipa de agentes de IA com papéis definidos que colaboram numa tarefa.

Imagina que queres produzir conteúdo para Instagram:

| Agente | O que faz | |--------|-----------| | Pesquisador | Encontra notícias e tendências do sector | | Estrategista | Define o ângulo e a abordagem | | Redactor | Escreve o copy do carrossel | | Designer | Cria as imagens | | Revisor | Valida a qualidade antes de publicar |

Cada agente executa a sua parte em sequência. O pipeline pode pausar em checkpoints — momentos onde o agente pede a tua aprovação antes de continuar.

Para quem é o Colony?

Para qualquer pessoa ou equipa que queira automatizar trabalho repetitivo com agentes de IA.

• Criadores de conteúdo — pesquisa, redacção e design para redes sociais, blogs e newsletters
• Agências e freelancers — pipelines reutilizáveis para múltiplos clientes
• Equipas de marketing — produção de conteúdo consistente com aprovação humana
• Equipas de RH — triagem de candidaturas, comunicações e onboarding
• Equipas de gestão — relatórios e apresentações a partir de dados em bruto

O que podes automatizar?

• Carrosséis, posts, artigos, newsletters, threads — com publicação automática
• Transformar vídeos em reels, artigos ou threads
• Análise de dados e criação de apresentações
• Campanhas completas: emails, WhatsApp, páginas de venda, roteiros de CPL
• Tutoriais com capturas de ecrã geradas automaticamente
• Radar de tendências que alimenta outros squads

Instalação

Pré-requisito: Node.js 20+

Na pasta do teu projecto:

npx colony init

Para actualizar:

npx colony update

IDEs Suportadas

| IDE | Estado | |-----|--------| | Claude Code | ✅ Disponível | | Cursor | ✅ Disponível | | VS Code + Copilot | ✅ Disponível | | Codex (OpenAI) | ✅ Disponível | | Open Code | ✅ Disponível | | Antigravity | ✅ Disponível |

Abre sempre a tua IDE na pasta onde correste npx colony init. O comando /colony só funciona quando a IDE está nessa pasta.

Criar um Squad

Abre o menu principal:

/colony

Ou descreve directamente o que precisas:

/colony cria um squad que escreve carrosséis de Instagram a partir de notícias
/colony cria um squad que produz todos os materiais de lançamento de um infoproduto
/colony cria um squad que converte vídeos do YouTube em cortes virais

O Arquitecto faz algumas perguntas, projecta o squad e configura tudo automaticamente. Aprovias o design antes de qualquer execução.

Executar um Squad

/colony run <nome-do-squad>

O squad executa passo a passo. Nos checkpoints, o agente pausa e aguarda a tua aprovação antes de continuar.

Dashboard — Escritório Virtual

O Colony inclui um Escritório Virtual: uma interface 2D que mostra os teus agentes a trabalhar em tempo real.

Podes ver o estado de cada agente (a trabalhar, em reunião, concluído), acompanhar o progresso do pipeline e usar o Commander para enviar instruções directas a qualquer agente durante uma execução.

Para abrir o dashboard, na pasta do teu projecto:

colony dashboard

O Colony detecta automaticamente a pasta de squads, instala as dependências na primeira execução e abre o servidor em http://localhost:5173.

Comandos de Referência

Na IDE (slash commands)

| Comando | O que faz | |---------|-----------| | /colony | Abre o menu principal | | /colony run <nome> | Executa um squad | | /colony create | Cria um novo squad | | /colony edit <nome> | Edita a configuração de um squad | | /colony list | Lista todos os squads | | /colony help | Mostra todos os comandos disponíveis |

No terminal (CLI)

| Comando | O que faz | |---------|-----------| | colony init | Inicializa o Colony numa pasta | | colony update | Actualiza o Colony | | colony dashboard | Abre o Escritório Virtual | | colony install <nome> | Instala uma skill | | colony uninstall <nome> | Remove uma skill | | colony skills | Lista as skills instaladas | | colony agents | Lista os agentes instalados | | colony runs [squad] | Consulta o histórico de execuções |

Estrutura de Ficheiros

Depois de colony init, a estrutura criada é:

_colony/          → Núcleo do Colony (não modificar manualmente)
  _memory/        → Contexto da empresa (carregado em todos os runs)
squads/           → Os teus squads
  <nome>/
    squad.yaml    → Configuração do squad (agentes, pipeline, skills)
    state.json    → Estado em tempo real (lido pelo dashboard)
    output/       → Outputs de cada execução
    _memory/      → Memória persistente entre runs
skills/           → Skills instaladas (integrações, scripts, prompts)

Skills

As skills são integrações que estendem o que os agentes podem fazer:

• Publicação automática — Instagram, LinkedIn, Twitter/X
• Geração de imagens — DALL·E, Stable Diffusion, Canva
• Email — envio via Resend
• Scraping e pesquisa — Apify, navegador headless
• Criação de templates — HTML/CSS para slides e carrosséis

colony install <nome-da-skill>

Sessões de Navegador e Privacidade

Quando forneces URLs de referência durante a criação de um squad (ex: "segue o estilo do @fulano"), o Colony usa um navegador headless para visitar essas páginas e extrair padrões de conteúdo.

• Login manual: na primeira vez que uma plataforma requer login, o Colony pede que entres manualmente e pergunta se queres guardar a sessão.
• Cookies persistentes: se autorizares, os cookies ficam guardados localmente em _colony/_browser_profile/. Esta pasta nunca é incluída no git.
• Revogar sessões: apaga a pasta _colony/_browser_profile/ para remover todos os dados de sessão guardados.

Licença

O Colony é um produto comercial com licença vitalícia — pagas uma vez, usas para sempre.

Adquire a tua licença em: colony.luandafurtunato.com

Após a compra recebes uma chave de licença por email. Introduz essa chave quando correres colony init pela primeira vez.

Custo de Tokens da IA

O Colony em si não cobra por uso. Os custos de tokens dependem da stack de IA que usas:

• Gratuito: Google Antigravity (free tier com Gemini) ou Open Code com LLMs locais
• Pago: Claude Code (Claude Pro/Max), API da Anthropic, API da OpenAI

Cada execução de squad consome tokens — a quantidade depende do número de agentes, da complexidade do pipeline e do modelo. Recomendamos monitorar o consumo na tua IDE ou no painel do fornecedor de IA.

Colony (English)

Create AI agent teams that work together — right from your IDE.

Colony is a multi-agent orchestration framework. You describe what you need in plain language, the Architect builds a team of specialized agents, and they execute the work automatically — step by step, pausing for your approval at the right moments.

What is a Squad?

A squad is a team of AI agents with defined roles that collaborate on a task.

For example, an Instagram content squad:

| Agent | What it does | |-------|--------------| | Researcher | Finds news and industry trends | | Strategist | Defines the angle and approach | | Writer | Writes the carousel copy | | Designer | Creates the images | | Reviewer | Validates quality before publishing |

Each agent runs in sequence. The pipeline can pause at checkpoints — moments where the agent asks for your approval before continuing.

Who is Colony for?

Anyone or any team that wants to automate repetitive work with AI agents.

• Content creators — research, writing and design for social media, blogs and newsletters
• Agencies and freelancers — reusable pipelines for multiple clients
• Marketing teams — consistent content production with human approval
• HR teams — application screening, communications and onboarding
• Management teams — reports and presentations from raw data

What can you automate?

• Carousels, posts, articles, newsletters, threads — with automatic publishing
• Turn videos into reels, articles or threads
• Data analysis and presentation creation
• Full campaigns: emails, WhatsApp, sales pages, CPL scripts
• Tutorials with auto-generated screenshots
• Trend radar that feeds into other squads

Installation

Prerequisite: Node.js 20+

In your project folder:

npx colony init

To update:

npx colony update

Supported IDEs

| IDE | Status | |-----|--------| | Claude Code | ✅ Available | | Cursor | ✅ Available | | VS Code + Copilot | ✅ Available | | Codex (OpenAI) | ✅ Available | | Open Code | ✅ Available | | Antigravity | ✅ Available |

Always open your IDE in the folder where you ran npx colony init. The /colony command only works when the IDE is opened in that folder.

Creating a Squad

Open the main menu:

/colony

Or describe what you need directly:

/colony create a squad that writes Instagram carousels from trending news
/colony create a squad that produces all launch materials for an info product
/colony create a squad that turns YouTube videos into viral clips

The Architect asks a few questions, designs the squad, and sets everything up automatically. You approve the design before any execution begins.

Running a Squad

/colony run <squad-name>

The squad runs step by step. At checkpoints, the agent pauses and waits for your approval before continuing.

Dashboard — Virtual Office

Colony includes a Virtual Office: a 2D interface that shows your agents working in real time.

You can see each agent's status (working, in a meeting, done), track pipeline progress, and use the Commander to send direct instructions to any agent during a run.

To open the dashboard, inside your project folder:

colony dashboard

Colony automatically detects the squads folder, installs dependencies on first run, and opens the server at http://localhost:5173.

Command Reference

In your IDE (slash commands)

| Command | What it does | |---------|--------------| | /colony | Open the main menu | | /colony run <name> | Run a squad | | /colony create | Create a new squad | | /colony edit <name> | Edit a squad's configuration | | /colony list | List all your squads | | /colony help | Show all available commands |

In the terminal (CLI)

| Command | What it does | |---------|--------------| | colony init | Initialize Colony in a folder | | colony update | Update Colony | | colony dashboard | Open the Virtual Office | | colony install <name> | Install a skill | | colony uninstall <name> | Remove a skill | | colony skills | List installed skills | | colony agents | List installed agents | | colony runs [squad] | View execution history |

File Structure

After colony init, the created structure is:

_colony/          → Colony core (do not edit manually)
  _memory/        → Company context (loaded on every run)
squads/           → Your squads
  <name>/
    squad.yaml    → Squad config (agents, pipeline, skills)
    state.json    → Real-time state (read by the dashboard)
    output/       → Outputs from each run
    _memory/      → Persistent memory between runs
skills/           → Installed skills (integrations, scripts, prompts)

Skills

Skills are integrations that extend what agents can do:

• Auto-publishing — Instagram, LinkedIn, Twitter/X
• Image generation — DALL·E, Stable Diffusion, Canva
• Email — send via Resend
• Scraping and research — Apify, headless browser
• Template creation — HTML/CSS for slides and carousels

colony install <skill-name>

Browser Sessions & Privacy

When you provide reference URLs during squad creation (e.g., "follow the style of @someone"), Colony uses a headless browser to visit those pages and extract content patterns.

• Manual login: the first time a platform requires login, Colony asks you to log in manually and asks whether you want to save the session.
• Persistent cookies: if you agree, cookies are saved locally in _colony/_browser_profile/. This folder is never committed to git.
• Revoke sessions: delete the _colony/_browser_profile/ folder to remove all saved session data.

License

Colony is a commercial product with a lifetime license — pay once, use forever.

Get your license at: colony.luandafurtunato.com

After purchase you will receive a license key by email. Enter that key when you run colony init for the first time.

AI Token Cost

Colony itself does not charge per use. Token costs depend on the AI stack you use:

• Free: Google Antigravity (free tier with Gemini) or Open Code with local LLMs
• Paid: Claude Code (Claude Pro/Max), Anthropic API, OpenAI API

Each squad run consumes tokens — the amount depends on the number of agents, pipeline complexity and the model. We recommend monitoring usage in your IDE or your AI provider's dashboard.