Primeiros Passos com o Arc OS

Arc OS — Sistema de Orquestração de IA para times de desenvolvimento. Este guia explica o que é o Arc OS, por que ele existe e como começar a usá-lo de forma eficaz.

O que é o Arc OS?

O Arc OS é uma plataforma que permite construir e gerenciar um time de desenvolvimento de IA pessoal em cima do Claude.

A ideia central: em vez de abrir um novo chat de IA toda vez que precisa de ajuda, você tem workers de IA persistentes que:

Conhecem seu codebase, arquitetura e histórico
Nunca perdem o contexto entre sessões
Cada um se especializa em um papel específico
Compartilham a mesma base de conhecimento do projeto

Você monta seu time uma vez. Depois trabalha com ele — via CLI, IDE ou web.

A Ideia Principal: Um LLM, Contexto Compartilhado, Papéis Especializados

A maioria dos desenvolvedores usa IA como um chat descartável — cola código, recebe resposta, esquece.

O Arc OS é diferente:

Um LLM (Claude) — todos os workers rodam no Claude. Escolhemos o Claude pela janela de contexto longa, pela aderência a instruções e pela qualidade de código. Você usa sua própria assinatura do Claude.

Sem perda de contexto — cada worker tem acesso a:

Sua wiki do projeto (decisões de arquitetura, convenções, anotações)
Suas skills (instruções personalizadas para tarefas específicas)
Seu rastreador de issues (o que está em andamento, o que está pronto)
Histórico de sessões (o que foi discutido antes)

Papéis especializados — cada worker tem personalidade, permissões e propósito diferentes:

Worker	Papel	O que faz
Developer	Acesso total	Escreve código, executa comandos, faz commits, depura
Consultant	Somente leitura	Revisa, explica, aconselha — nunca toca em arquivos
Designer	Foco em UI/UX	Design de componentes, acessibilidade, sistemas visuais
Sentinel	Segurança	Audita código, encontra vulnerabilidades, fortalece sistemas
Archivist	Documentação	Escreve docs, mantém a wiki atualizada, gera relatórios
Product Owner	Planejamento	Gerencia o roadmap, cria issues, prioriza o backlog

Você também pode criar workers personalizados para suas necessidades específicas.

O que é um Projeto?

Um projeto no Arc OS corresponde a um codebase ou produto em que você está trabalhando.

Cada projeto tem:

Seu próprio conjunto de workers (Developer, Consultant etc.)
Sua própria wiki (docs de arquitetura, decisões, convenções)
Suas próprias skills (instruções personalizadas injetadas nos workers)
Seu próprio rastreador de issues (tarefas, bugs, funcionalidades)
Seu próprio histórico de sessões

Você pode ter vários projetos — um por produto, cliente ou repositório.

A Forma Principal de Trabalhar: CLI Bridge

O CLI bridge é a interface principal do Arc OS. Ele conecta seu terminal local ou IDE diretamente aos seus workers de IA.

# Start a Developer session on project "my-app"
arc my-app developer

# Start a Consultant (read-only) session
arc my-app consultant

# Continue the previous session (restores context)
arc my-app developer continue

Quando você executa arc <project> <worker>, o worker:

Carrega a wiki do projeto, as skills e a issue ativa
Abre uma sessão interativa do Claude no seu terminal
Tem acesso total ao seu sistema de arquivos local (Developer) ou somente leitura (Consultant)
Salva o contexto da sessão para a próxima vez

Por que CLI-first?

Funciona em qualquer terminal (macOS, Linux, Windows)
Integra com VS Code, Cursor, JetBrains via painel de terminal
Sem troca de contexto — você fica no seu editor
Ciente do Git: o worker vê seu branch atual, alterações em staging e commits recentes

Principais Comandos do arc CLI

arc <project> <worker>               # Start a session
arc <project> <worker> continue      # Resume previous session
arc sessions <project>               # Browse past sessions
arc issues                           # List open issues
arc issue create --title "..."       # Create new issue
arc issue log <id> "progress note"   # Log progress
arc skill <name>                     # Load a skill into context
arc wiki                             # Browse project wiki
arc roadmap                          # View project roadmap
arc retro <project>                  # Reconstruct issues from history

Como Começar

Passo 1 — Instale o arc CLI

Baixe o binário para o seu sistema operacional no dashboard do Arc OS (Settings → CLI).

# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version

Passo 2 — Crie seu primeiro projeto

No dashboard CRM:

Clique em New Project
Dê um nome e conecte seu repositório do GitHub
O sistema cria seu time de workers automaticamente

Passo 3 — Adicione Skills (opcional, mas recomendado)

Skills são conjuntos de instruções personalizadas que tornam os workers mais inteligentes sobre o seu projeto:

Convenções de estilo de código
Padrões de arquitetura que você usa
Bibliotecas e frameworks da sua stack
Coisas que o worker deve sempre / nunca fazer

Vá em Skill Registry → Generate — o sistema lê seu codebase e sugere skills automaticamente.

Passo 4 — Inicie sua primeira sessão

arc my-project developer

O worker Developer vai se apresentar, carregar o contexto do seu projeto e aguardar sua primeira tarefa.

Passo 5 — Conecte o Telegram (opcional)

Se quiser enviar mensagens rápidas aos workers pelo celular ou quando estiver longe do computador, conecte o Telegram via Settings → Telegram Bot.

O Telegram é opcional — toda a funcionalidade principal funciona pelo CLI.

Como os Workers Compartilham Conhecimento

Todos os workers do mesmo projeto compartilham:

Wiki — documentos markdown que você ou os workers escrevem sobre o projeto. Decisões de arquitetura, convenções de API, "coisas a saber", notas de onboarding. Os workers leem a wiki automaticamente no início da sessão.

Skills — conjuntos de instruções reutilizáveis. Uma skill de "TypeScript strict mode" ou "sempre escrever testes primeiro" é injetada em toda sessão de worker relevante.

Issues — quando um worker está trabalhando na issue #42, ele conhece esse contexto. Outros workers conseguem ver o que está em andamento.

Histórico de sessões — os workers podem referenciar o que foi discutido em sessões anteriores via arc sessions ou continue.

Standard Cloud — Workspace Sempre Ativo

O Standard Cloud já está disponível. Com uma assinatura Standard Cloud, você recebe um contêiner Docker dedicado nos servidores do Arc OS (Hetzner).

O que isso te dá

Arquivos de projeto persistentes no VPS Seu diretório /workspace vive no servidor — não no seu laptop. Os arquivos estão lá quando você volta, mesmo depois de fechar o computador.

/workspace/my-project/   ← your code, always available
/home/arcuser/.claude/   ← Claude auth, persisted
/home/arcuser/.ssh/      ← GitHub SSH key, persisted

Sincronização com o GitHub via SSH O contêiner tem uma chave SSH dedicada conectada à sua conta do GitHub. Você faz git clone uma vez — depois git pull / push de qualquer lugar sem reautenticar.

# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git   # once
git pull                                    # any time, from any device

Acesso de qualquer dispositivo Abra o CRM do Arc OS pelo celular, tablet ou outro computador — seu workspace e arquivos estão exatamente onde você os deixou. Acabou o problema de "deixei o projeto na outra máquina".

Continue de onde parou

# In Telegram, next morning:
/continue

# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...

O worker retoma o contexto da sessão anterior e continua trabalhando — enquanto você toma seu café.

O que está incluído

Funcionalidade	Free / Local	Standard Cloud
arc CLI (local)	✅	✅
Dashboard CRM	✅	✅
Workspace VPS persistente	❌	✅
Integração SSH com GitHub	❌	✅
Acesso de qualquer dispositivo	❌	✅
/continue pelo Telegram	❌	✅
Arquivos sobrevivem ao fechar o laptop	❌	✅

Como ativar

Vá em Billing → Standard Cloud
Assine (veja o preço atual no dashboard)
Clique em Create Cloud Workspace — o contêiner fica pronto em menos de 60 segundos
Conecte o Claude Code (sua assinatura Claude Pro)
Conecte a chave SSH do GitHub
Clone seu projeto em /workspace

Sua assinatura Claude Pro/Max é separada — você traz a sua. O Arc OS não cobra pelo uso do Claude.

O que o Arc OS NÃO é

Não é um agente autônomo — os workers não rodam em segundo plano sem você. Toda sessão começa quando você a abre.
Não é um bot de atendimento ao cliente — os workers falam com você (o desenvolvedor), não com seus usuários finais.
Não é uma ferramenta de automação de workflows — o Arc OS não se conecta a APIs externas por conta própria. Os workers ajudam você a escrever o código que faz isso.
Não é um substituto do Claude.ai — o Arc OS é construído em cima do Claude, com contexto de projeto e estrutura de time adicionados.

Primeiras Perguntas Comuns

P: Preciso do Telegram? Não. O Telegram é opcional. O CLI bridge é a interface principal.

P: Os workers compartilham contexto entre si? Sim — por meio da wiki compartilhada, das skills e do rastreador de issues. Eles não compartilham o estado da sessão ao vivo, mas leem a mesma base de conhecimento.

P: Posso personalizar os workers? Sim. O Worker Studio (no CRM) permite editar o system prompt, as skills e o comportamento de cada worker.

P: Como funciona o billing? Você usa sua própria assinatura Claude Pro ou Max. O Arc OS não adiciona cobranças pelo uso do Claude — você paga diretamente à Anthropic. O Arc OS cobra uma taxa de plataforma pelo dashboard e pelas ferramentas.

P: E se eu quiser um tipo de worker que não está na lista? Crie um worker personalizado no Worker Studio. Defina o papel, as permissões e injete as skills que precisar.

Seus Dados e Privacidade

O Arc OS foi projetado para manter seus dados sob o seu controle.

Exporte seus dados (GDPR Art. 20)

Você pode baixar uma exportação JSON completa de todos os dados da sua conta a qualquer momento:

Vá em Settings → Security → Download my data
Um arquivo JSON é gerado e baixado imediatamente

A exportação inclui informações da conta, projetos, histórico de chat, issues, páginas da wiki, skills e logs de atividade. Limitado a 3 exportações por 24 horas.

Exclua sua conta (GDPR Art. 17)

Você pode excluir sua conta permanentemente a qualquer momento:

Vá em Settings → Security → Delete account
Confirme a exclusão

Isso apaga imediata e permanentemente todos os seus dados em todas as tabelas — projetos, histórico de chat, skills, entradas do vault, logs de atividade e o registro da sua conta. Esta ação é irreversível.

O que nós não fazemos

Não usamos seu código, prompts ou respostas de IA para treinar modelos
Não embutimos rastreadores de publicidade nem SDKs de analytics
Não definimos cookies HTTP — todo o estado da sessão fica no localStorage
Não compartilhamos seus dados com terceiros além do necessário para operar o serviço (CDN Cloudflare, inferência de IA da Anthropic, provedores de OAuth)

Para a política completa, veja a Política de Privacidade.