Copilot Delegate
Delegação inteligente com tentáculos autônomos
O que é
Um polvo orquestrador para suas tarefas de desenvolvimento
O cérebro do polvo não move os braços — ele os direciona.
Copilot Delegate é uma extensão VS Code que transforma o GitHub Copilot em um orquestrador inteligente. O Agent Octopus — Orchestrador de Orchestradores — nunca implementa diretamente. Ele classifica tarefas, resolve conflitos potenciais e delega para sessões CLI isoladas, cada uma rodando em seu próprio git worktree.
Cada tentáculo é uma sessão CLI isolada, trabalhando em paralelo. O Agent Octopus coordena via Signal Bus, monitora com mid-flight reactive control e faz merge automático com validação de testes. Zero conflitos. Zero microgerenciamento.
Polvos caçam em dois modos. No modo solo, a cabeça direciona tentáculos diretamente — paralelismo plano. No modo coletivo, braços especializados coordenam seus próprios tentáculos — hierarquia fractal. Copilot Delegate suporta ambos.
Features
75 tools registradas, cada uma como um tentáculo especializado
75 Tools de Delegação
75 LanguageModelTools registradas — incluindo classify_delegation, query_lessons, acknowledge_lesson, delegate_task com TaskWeight, runTests, retry tools, multi-dev hierarchy (spawn/send/respond_boss/retire/revive/peek), Boss Picker (showActive QuickPick), brain_research, write_curated_config, party_* (DSTP), list_models, show_active_account. Prompts em inglês para máxima precisão — zero telemetria.
Browser Bridge + Transport Telemetry
Novo BrowserBridgeAdapter permite ao Brain Research buscar fontes via browser automation com suporte a JavaScript. Telemetria de transporte por adapter: latência, bytes transferidos e qualidade de resposta reportados no GateTelemetry para análise de performance e tuning de fontes.
KB Dedupe via Consolidator LLM
Deduplicação da Knowledge Base migrada do heurístico para o LLM consolidador. O consolidador avalia semanticamente entradas duplicadas e consolida em única entrada enriquecida — resolve o bug de contador preso e entrega KB mais limpa com retrieval de maior precisão.
Worktree Isolation
Cada sessão roda em git worktree isolado — execução paralela sem conflitos de código.
Auto-Merge Hardened
Merge com verificação pós-merge, validação de paths, sanitização de branches. Testes opt-in — só rodam quando explicitamente pedido. Callbacks expõem merge status explicitamente. dirty_working_tree classificado separadamente de conflitos.
Pipeline Sequencial
Encadeie 2–10 sessões sequenciais. Output de step N vira contexto de step N+1.
Discovery Pipeline
6 steps de análise autônoma para onboarding em projetos — detecta stack, analisa arquitetura, extrai patterns e gera documentação completa automaticamente.
Fun Aliases Satíricos
Pipelines recebem nomes como "operation-broccoli" e "pipeline-tofu". Muito mais memorável que UUIDs.
Advisory File Lock
Locks por arquivo impedem que sessões concorrentes editem os mesmos arquivos críticos.
Mid-Flight Reactive Control
Pause, resume, stop, switch model, set mode — controle reativo total durante a execução. Agent Octopus pode intervir e ajustar sessões em tempo real.
Status Bar + Sidebar
N tentacle(s) na status bar. 5 seções na sidebar com branding octopus completo.
Auto-Cleanup
Sessões auto-limpas após merge. Verifica pendências, commit, remove worktree/branch.
Session History
Persistência das últimas 50 sessões via globalState — sobrevive a restarts do VS Code.
Octopus Branding
Notificações temáticas ("Tentacle spawned", "Ink absorbed"), tooltips, welcome view e fun facts.
Session Learning v3
MiniSearch BM25-like full-text search com fuzzy matching e field boosting. Sessões chamam query_lessons com busca semântica e acknowledge_lesson para marcar lições úteis. Scoring explícito via acknowledgment — só incrementa promotionScore quando a sessão confirma uso. Modo reference (default) injeta instrução de consulta.
Task Ledger
Registro automático de delegações completadas. Per-project no globalState (FIFO 200). Tags derivadas de commit messages. Prompt #ledger para consulta.
Activity-Based Timeout
Detecção de inatividade via lastEventAt (threshold 10min configurável). Safety net maxWallClockMs. Substitui timeout fixo de 30min.
Confirm Delegate Hook
PreToolUse hook que valida se o template de confirmação foi mostrado ao usuário lendo o transcript JSONL; bloqueia delegações com deny quando ausente e permite delegações sequenciais após confirmação.
Artifact Catalog
Catálogo de artefatos com persistência via globalState e sidebar provider dedicado.
Chat Session Purge
Purge de sessões delegate do painel de Chat via SQLite WASM. Auto-purge após merge. Comando dedicado.
Close Chat Tabs
Tabs do editor automaticamente fechadas após merge — 4 pontos de integração para limpeza completa.
Reactive Conflict Escalation
Resolução automática de conflitos: lockfiles, generated files, whitespace. Escalação para user em conflitos reais.
Smart Test Detection
detectTestCommand() lê package.json scripts.test em vez de hardcodar. Suporta qualquer test runner.
Package Manager Detection
detectPackageManager() detecta bun/pnpm/yarn/npm por lockfile. Worktrees instalados com o package manager correto.
Copilot CLI Auto-Detection
Auto-detecção e instalação do Copilot CLI no activate(). Se ausente, tenta npm install -g automaticamente. UX amigável com status bar indicator, retry command e link de ajuda.
@remote Chat Participant
Agente completo com tool-calling agent loop para controle remoto via Android. Acesso a todas as tools do VS Code. Workspace context com cache TTL 30s. Max 10 rounds de tool calls.
Reef Panel
Painel de gerenciamento do daemon na sidebar. Detecta daemon via registry, reconhece instâncias externas rodando.
Daemon Standalone
Download e execução do daemon remote-vscode como executável standalone. Sem auto-start — user controla lifecycle via sidebar. Auto-update quando já online.
Callback Enriquecido
Resultado de sessões delegadas com resumo completo: alias, duração, status, files changed, lessons capturadas e merge info. Tudo em uma mensagem estruturada.
Security Audit Template
Template de pipeline para auditoria de segurança automatizada do projeto.
Step Timeout Configurável
Timeout configurável por step em pipelines. Controle granular de execução.
Agent Profiles
Sistema de perfis com switch via sidebar. Perfis controlam paralelismo, modelo preferido e comportamento. 4 perfis built-in: balanced, speed, quality, economy. Extensível com perfis customizados.
Task Map
Toggle na sidebar para geração automática de task maps. Ao final de delegações, injeta instrução pro LLM gerar mapa de tarefas com intent, decisões, arquivos alterados e contexto de continuidade em docs/maps/.
Model Balancing
Seleção dinâmica de modelo por billing tier e effort balancing por taskWeight. Modelos são escolhidos automaticamente com base no multiplicador de billing da subscription e complexidade da tarefa.
TaskWeight Classification
Classificação heurística de complexidade: ultralight, light, standard, heavy, gate-only. Testes opt-in via runTests em merge, cleanup e pipeline validators — elimina overhead de 60-120s por delegação.
Modo Coletivo (Multi-Dev)
Hierarquia fractal de 3 níveis: Cabeça (L1, boss) → Braços (L2, leads especializados — Tech, Product, QA, Facilitator) → Tentáculos (L3, sessões CLI). A cabeça nunca implementa, só orquestra. Cada braço comanda seus próprios tentáculos em paralelo. Ideal para features multi-frente e releases coordenadas.
BossesPanel Full-Tab
Painel dedicado para gerenciamento de bosses multi-dev. Waves 1–4: disband/spawn, broadcast, show-retired, group-by-feature, filter/search, per-dev peek (👁 abre transcript). matchesFilter unificado via FILTER_PREDICATE_SOURCE — zero drift JS/TS.
Boss Picker
Status bar item mostrando boss ativo + QuickPick showActive para selecionar entre bosses. Sidebar view BossesWebviewProvider. ActiveBossSnapshot com debounce de onDidChange — zero polling, reativo a eventos do registry.
Brain Research Orchestrator
9 adapters de pesquisa: brave, github-code, mdn, npm-registry, stackoverflow, ddg-html, custom-url, kb-local, workspace-files. Semantic cache cosine similarity, freshness filter, cross-source dedup. Trace-store persistente, kb-persist com Migration V7 (trace↔KB cross-reference), exponential retry.
Brain Privacy & Consent
Consent modal privateOnly com ConsentManager state machine. Utilization scanner (5min tick, 60min window, passive text matching). Pin/dismiss user state com retriever boost/filter. Trace timeline panel com live streaming e replay. Aba Pesquisa com 5 seções: privacy, adapters, authority, quality, history.
Brain Query Rewriter
QueryRewriter via vscode.lm reescreve a query do usuário antes da fase de retrieval, melhorando recall em prompts verbosos. Wired na Cascade (segundo pass) e no GateOrchestrator com auto-select de modelo Copilot. Settings copilot-delegate.brain.queryRewriter.* controlam habilitação, modelo e prompt; telemetria expandida com rewriter* fields.
Brain Panel — Health & Drill-down
Painel Brain ganhou health banner, card de Rewriter Model, sparklines com buckets temporais (getGateTelemetryBuckets), tiles agregados de top-errors, drill-down nativo e export CSV via diálogo do VS Code. Aba Models renomeada inclui seção dedicada de rewriter.
Shell Tune Detect
PostToolUse hook em run_shell grava marker no TMPDIR quando shell curado cai em defaults. ShellTuneWatcher delega sessão CLI shell-tuner para refinar outputFilter/outputLines/timeoutMs em shells.json. Agent shell-creator materializa PatternSuggestion em shell curado via auto-curate do pattern-store. write_curated_config faz dedup por label::command (lowercase).
Task Map Enforcement
Tool create_task_map e hook taskmap-guard garantem geração de task maps ao final de cada delegação. Template bundled em resources/templates/ com estrutura padronizada de intent, decisões e contexto de continuidade.
Dynamic Hook Registration
Registro dinâmico do hook taskmap-guard ao ativar/desativar o toggle de Task Map. Hooks são preservados durante troca de perfil e normalizados com CRLF em switchProfile.
Lesson Deduplication
Deduplicação semântica de lições via vscode.lm API. Auto-trigger a cada 10 lições + comando manual. LLM identifica lições redundantes e consolida em uma única lição enriquecida.
Skill Promotion
Promoção automática de lições recorrentes para Skills reutilizáveis. Três modos: off, notify e auto. Sidebar toggle com cycle command e threshold configurável.
Octopus v2 Smart Router
Agent Octopus reescrito como smart router com 3 paths: FAST (resolve direto <30s), DELEGATE (sessão CLI isolada) e MIXED (parte rápida + delegação paralela). 8 bundled agents: implementor, researcher, validator, planner, reviewer, debugger, documenter, tester.
Meridian Auto-Setup
Download automático do binário Meridian Client de GitHub Releases, auto-extração, setup command e meridian_setup LLM tool. Sidebar mostra versão, status e detecção de atualizações.
Cooperation Mode
Callbacks para extensões externas via commands registrados. Permite integração bidirecional com outras extensões do ecossistema VS Code.
Model Policy Engine
Seleção de modelo por tier com priority chain: input override → step type policy → profile policy → task weight → global fallback. Substitui abordagem billing-only.
Meridian Tunnel Bridge
Relay TCP transparente (yamux over WSS) para Android Bridge via relay público. Config YAML gerado em runtime, auth via SecretStorage. Reconexão automática.
Enriched Pipeline Callbacks
Callbacks de pipeline enriquecidos com Result, Report, Duration, Lessons, Files changed e merge status explícito. Suprime hints obsoletos de check_session em steps com autoMerge.
Acknowledge Lesson
Tool acknowledge_lesson permite que sessões CLI marquem explicitamente quais lições foram úteis. PromotionScore só incrementa por acknowledgment — elimina promoções espúrias de lições apenas consultadas.
Palette Purge
Paleta enxuta com apenas 3 comandos visíveis: openSettings, openDocs, emergencyStopAll. 93 comandos escondidos — ações migradas para botões em painéis com confirmação visual.
Operations Panel (4 Tabs)
Painel unificado com tabs Maintenance, Shells, Delegation e Sessions. Action-cards com confirmação visual substituem comandos da palette. Danger buttons com toggle de confirmação para ações destrutivas.
Panel Migrations
Brain capture form, Party Start tab e Lessons danger confirm migrados de Command Palette para painéis webview dedicados. UX nativa com formulários, toggles e toast notifications.
Danger Zone & Confirm
Daemon Danger Zone e Patterns reject confirm: ações destrutivas agora exigem confirmação visual explícita no painel. Previne exclusões acidentais com toggle de segurança.
Dois Modos de Caça 🐙
O polvo se adapta ao alvo — controle direto ou hierarquia especializada
Caça Solo
ClássicoA cabeça controla tentáculos diretamente.
Cabeça (L1)
Decide e despacha
Tentáculos (L3)
N sessões CLI em paralelo
Ideal para: refactors, research, testes, tarefas táticas em paralelo plano.
Caça Coletiva
Multi-DevBraços especializados comandam seus próprios tentáculos.
Cabeça (L1)
Orquestra, nunca implementa
Braços (L2)
Tech · Product · QA · Facilitator
Tentáculos (L3)
N sessões CLI por braço
Ideal para: features multi-frente, releases coordenadas, projetos com tech + product + QA em paralelo.
Anatomia do Coletivo
Biology Features 🧬
Auto-recuperação, monitoramento e proteção inspirados em biologia marinha
Auto-Retry com Backoff
Retry automático com backoff exponencial em falhas de conexão. Sistema self-healing.
Health Monitor + Heartbeat
Heartbeat a cada 30s, marca sessões como unresponsive após 2min sem eventos.
Ink Cloud (Emergency Stop)
Para todas as sessões simultaneamente e salva snapshot de estado para recovery.
Conflict Radar (Ventosas)
Detecta conflitos de arquivo entre sessões concorrentes antes de causar problemas.
Pipeline Templates
11 templates built-in em inglês com separação de responsabilidades: research-first, quick-fix, refactor, test-coverage, discovery, security-audit, validation-only, implement-only, tech-doc, tool-discovery e boilerplate-analysis. Tabela de seleção no octopus.agent.md.
Live Progress com Phases
4 fases com cores: starting, active, unresponsive, completing. Tracking visual.
Offline Mode
Deep water mode com queue de mensagens e auto-reconnect.
Camouflage Profiles
4 profiles pré-configurados que mudam comportamento do sistema.
Android Bridge 📱
Delegue tarefas do celular direto pro VS Code
⚙️ Como Ativar
No VS Code Settings, adicione:
{
"copilot-delegate.androidBridge.enabled": true,
"copilot-delegate.androidBridge.port": 3334
}Bridge inicia automaticamente em localhost:3334
📥 Download do APK
Baixe o APK do Copilot Octopus (última versão):
📥 Download APKRequer rede local (WiFi) — Android e PC na mesma rede
🛡️ Features do Bridge
- WebSocket com autenticação por token
- Progress broadcasting em tempo real
- Suporte a 10 tarefas simultâneas
- Token auto-gerado pelo daemon
- Localhost-only (segurança)
- Discovery via daemon registry
🚀 Quick Start
- Ative o bridge no VS Code Settings
- Baixe o APK do Copilot Octopus
- Conecte Android na mesma WiFi do PC
- Abra o app e submeta tarefas para o @octopus
Como Funciona
Do pedido do usuário ao merge automático — tudo orquestrado
Usuário
Descreve a tarefa no chat do Copilot
Agent Octopus
Orchestrador de Orchestradores — analisa, classifica, resolve conflitos e despacha para workers
Tentacles
Sessões CLI isoladas em worktrees paralelos
Merge
Auto-merge com validação de testes obrigatória
Patterns de Delegação
9 patterns recomendados pelo Skill Octopus
Fire-and-Forget
Tarefas independentes — delega e segue. Callback automático traz resultado.
#delegate_task prompt="Crie testes para auth.ts"
Pipeline Sequencial
Research → implement → test em cadeia. Output propaga entre steps.
#delegate_pipeline steps=[research, implement, test]
Discovery → Implementation
Projeto desconhecido — discover primeiro, implemente depois com contexto.
#discover_project → #delegate_pipeline
Delegação Paralela
Múltiplas tarefas independentes em worktrees isolados simultâneos.
#delegate_task × N com isolateWorktree: true
Mid-Flight Control
Revisar plano antes de executar, ajustar modelo e modo durante execução.
#switch_model → #set_session_mode → #send_message
Context Compaction
Sessões longas chegando no limite de contexto — compacta sem perder informação.
#compact_session sessionId="abc123"
Research-First Pipeline
Pesquisa obrigatória antes de implementação — garante contexto completo.
#delegate_pipeline [researcher → implementor]
Signal Bus Coordination
Coordenação entre tentáculos paralelos via pub/sub — broadcast e receive signals.
#broadcast_signal → #receive_signals
Clone & Retry
Clone sessão falha com contexto preservado para nova tentativa — aprenda com erros.
#clone_session sessionId="abc123" newPrompt="Fix X"
Sidebar Preview
5 seções com branding octopus na sidebar do VS Code
Fun Facts
Biologia real que inspirou cada feature
9 cérebros, 1 mente
Polvos têm um cérebro central e 8 gânglios braquiais autônomos — cada braço processa localmente, mas a coordenação vem do topo. É exatamente a arquitetura do Modo Coletivo: a Cabeça (L1) decide e despacha, mas cada Braço (L2) tem inteligência própria pra coordenar seus tentáculos.
500 milhões de neurônios
2/3 dos neurônios estão nos braços, não no cérebro. Cada braço é um sistema nervoso semi-autônomo.
🔗 Cada tentáculo (sessão CLI) tem inteligência própria — o dispatcher só direciona.
3 corações, sangue azul
Dois corações brânquiais bombeiam para as guelras, um coração sistêmico para o corpo. Sangue azul com hemocianina (cobre).
🔗 Redundância de failover — múltiplos sistemas mantêm a operação mesmo com falhas.
Camuflagem instantânea
Muda de cor em frações de segundo com cromatóforos, iridóforos e leucóforos. O polvo-mímico imita até 18 espécies.
🔗 Modo Camouflage — adapta interface e comportamento ao contexto do usuário.
Braço cortado continua funcionando
Um braço removido executa reflexos, agarra objetos e responde a estímulos. Loops neurais dão memória de curto prazo.
🔗 Worktree isolation — sessões funcionam independentemente. Signal Bus permite coordenação quando necessário.
Uso de ferramentas
Únicos invertebrados com uso complexo de ferramentas — carregam cascas de coco como abrigo portátil.
🔗 69 tools especializadas — Agent Octopus sabe quando usar cada ferramenta para cada tarefa.
Socos em peixes não-cooperativos
Em caça cooperativa com peixes, polvos regulam parceiros dando "socos" nos que não cooperam.
🔗 Mecanismos de retry, timeout e fallback para workers não-responsivos.
Tech Stack
Construído com tecnologias modernas e zero dependências pesadas
TypeScript
Linguagem principal
VS Code API
Tools, TreeView, Webview
Copilot CLI SDK
Integração @github/copilot
Zod
Validação de schemas
esbuild
Build e bundling
Vitest
Framework de testes
sql.js
WASM SQLite — Zero dependências nativas