Arc OS — Guia do Usuário

Guia completo de todas as funcionalidades do dashboard CRM do Arc OS. Última atualização: 2026-05-04 (Phase 52.1)

Visão geral das funcionalidades

graph LR
    Login[1. Login + código de convite]
    Dash[2. Visão geral de projetos]
    Onb[3. Wizard de criação de projeto]
    Work[4. Workspace + Workers]
    Time[5. Replay no Timeline]
    Iss[6. Issues redesenhado]
    Skill[7. Skills + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Período gratuito + Billing]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Índice

1. Primeiros Passos
2. Layout do Dashboard
3. Workspace — AI Workers
4. Anexos de Arquivo
5. Pastas — Gerenciador de Arquivos
6. Worker Studio — Workers Personalizados
7. Issues
8. Wiki
9. Knowledge Graph
10. Skill Evolution
11. Roadmap
12. Relatórios
13. Analytics
14. NotebookLM — Memória Neural
15. Cloud PM — Chat do Projeto
16. Configurações do Projeto
17. Integração com Telegram
18. Tema e Configurações
19. Atalhos de Teclado
20. Solução de Problemas
21. Timeline (Phase 47)
22. Créditos do Período Gratuito e Billing
23. Acesso Beta — Códigos de Convite

1. Primeiros Passos

Acesso beta (Phase 52.1): O registro público é atualmente restrito a convidados. Você precisa de um código de convite no formato arc-XXXX-XXXX para criar uma conta. Veja §23 Acesso Beta para saber como obtê-lo.

Fluxo de Onboarding — Storyboard

sequenceDiagram
    autonumber
    actor U as You
    participant L as Login Screen
    participant E as Email
    participant W as Onboarding Wizard
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: paste invite code arc-XXXX-XXXX
    L->>L: validate format
    U->>L: enter email + password + name
    L-->>E: send verification link (24h TTL)
    U->>E: click verification link
    E->>L: redirect → logged in
    L->>W: first-time user → wizard
    U->>W: name project · pick blueprint · set Anthropic key (optional)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · create dirs · clone blueprint · spawn child bot
    M-->>W: project ready
    W->>Wo: redirect to /project/<name>
    U->>Wo: send first message
    Wo-->>U: stream tokens via SSE

Tempo estimado: meta de ≤10 min desde a inserção do código de convite até a primeira resposta da IA. Passos 1-5 ≈ 3 min, passos 6-9 ≈ 2 min, primeiro chat ≈ 1-5 min dependendo do clone do blueprint.

Login

O Arc OS suporta três métodos de autenticação:

Opção A: Email e Senha

1. Acesse o dashboard CRM (https://arc-os.co ou http://<servidor>:18888).
2. Clique em Criar Conta na tela de login.
3. Informe seu email, nome de exibição, senha e seu código de convite (arc-XXXX-XXXX).
4. Verifique seu email pelo link enviado para sua caixa de entrada (TTL de 24h).
5. Faça login com email e senha.

Opção B: OAuth (Google / GitHub)

1. Acesse a tela de login do CRM.
2. Clique em Continuar com Google ou Continuar com GitHub.
3. Autorize na janela popup.
4. Você será redirecionado de volta e autenticado automaticamente.

Todos os métodos geram um token JWT (válido por 24 horas) armazenado no seu navegador.

Primeiros Passos

Após o login, você verá a visão Todos os Projetos. Use o seletor de workspace no header para alternar entre projetos, ou clique em Todos os Projetos para ver o dashboard global.

2. Layout do Dashboard

Header Superior

Sidebar

Menu de navegação recolhível (clique no hambúrguer para alternar). Mobile: painel sobreposição com backdrop.

Páginas globais (visíveis em Todos os Projetos):

• Analytics — visão geral da saúde do sistema, cards de status dos projetos
• Issues — rastreador de issues entre projetos
• Relatórios — relatórios de analytics
• Skills Registry — gerenciamento global de skills com Sage Worker
• Arquivos — gerenciador de arquivos
• NotebookLMs — notebooks de memória neural vinculados

Páginas do projeto (visíveis quando um projeto está selecionado):

• Workspace — interface de chat/terminal de IA (área de trabalho principal)
• Issues — rastreador de issues do projeto
• Roadmap — roadmap do projeto com phases
• Relatórios — relatórios do projeto
• Skills — skill evolution com Sage Worker, benchmarks, marketplace
• Pastas — gerenciador de arquivos
• Wiki — páginas da base de conhecimento
• Graph — visualização do knowledge graph
• Configurações do Projeto — configuração do projeto, token do bot Telegram, presets de equipe

ContextRail (Painel Direito, ≥1280px)

Um painel de 320px à direita mostrando o contexto do projeto junto à página ativa. Seções:

• Current Goal — extraído da phase ativa do ROADMAP
• Métricas — grade 2×2 (issues, skills, atividade, etc.)
• Active Skills — skills carregadas na conversa do Workspace atual
• Notas fixadas — mensagens de workers fixadas nos threads de chat
• GitHub (Phase 49.3.1) — eventos recentes dos repositórios vinculados. Oculto automaticamente se o projeto não tiver repositórios vinculados. Veja Configuração da Integração GitHub.

3. Workspace — AI Workers

O Workspace é a interface principal de interação com a IA. Utiliza um sistema de Workers Dinâmicos, onde cada worker é um agente de IA especializado.

Workers Integrados

Barra de Workers

No topo do Workspace, você verá pills (botões) de workers:

• Ativo (colorido) — painel visível
• Inativo (acinzentado) — clique para exibir o painel
• Clique em um pill para alternar a visibilidade do painel do worker
• Pelo menos um worker deve estar ativo
• O layout persiste por projeto (salvo no localStorage)

Workers de Chat (Consultant)

Interface de bolhas no estilo chat:

• Digite sua mensagem no campo de entrada na parte inferior
• Pressione Enter para enviar (ou clique no botão Enviar)
• Pressione Shift+Enter para nova linha
• As respostas do bot são renderizadas em markdown (blocos de código, listas, cabeçalhos)
• Clique no botão de copiar em qualquer mensagem do assistente para copiá-la
• O streaming SSE mostra o status de processamento em tempo real

Workers de Terminal (Developer)

Interface de terminal com stream de log:

• Mostra eventos de execução de ferramentas em tempo real:
  • Thinking (ícone de cérebro, animação pulsante roxa)
  • Chamadas de ferramentas (Read, Edit, Bash, Grep, etc. com detalhes do arquivo/comando)
  • Texto de resposta (com botão de copiar)
• Indicador de processamento: ponto laranja pulsante
• Indicador de inatividade: ponto verde
• Até 300 entradas de log retidas

Seletor de Modelo

Na barra inferior de cada painel de worker:

• Clique no dropdown de modelo para alternar o modelo de IA
• Modelos disponíveis: Sonnet, Opus, Haiku
• A escolha do modelo persiste por projeto no localStorage

Ações Rápidas (Barra Inferior)

4. Anexos de Arquivo

Você pode anexar arquivos a qualquer mensagem de worker.

Como Anexar

1. Clique no ícone de clipe na área de entrada de mensagem, OU
2. Arraste e solte arquivos no workspace, OU
3. Cole uma imagem da área de transferência

Tipos de Arquivo Suportados

Chips de Anexo

Após anexar, os arquivos aparecem como chips acima da entrada:

• Arquivos de texto mostram o nome do arquivo
• Imagens mostram um thumbnail de 80x56px (clique para ampliar)
• PDFs mostram o nome do arquivo com ícone de PDF
• Clique em X em qualquer chip para removê-lo

Limites de Tamanho

• Arquivos de texto: até 512KB
• Imagens: comprimidas automaticamente (sem limite rígido; saída comprimida ~100-500KB)
• PDFs: transmitidos como base64 (recomendado < 10MB)

5. Pastas — Gerenciador de Arquivos

A página Pastas fornece um navegador de arquivos completo para o diretório do seu projeto no servidor.

Navegação

• Caminho breadcrumb no topo — clique em qualquer segmento para ir até aquele diretório
• Clique em uma pasta para abri-la
• Clique em um arquivo para visualizá-lo no painel lateral

Ações da Barra de Ferramentas

Menu de Contexto (Botão Direito)

Clique com o botão direito em qualquer item para opções adicionais:

Em arquivos:

• Abrir — visualizar no painel lateral
• Visualizar — mesmo que Abrir
• Baixar — baixar o arquivo para seu computador
• Excluir — excluir o arquivo (com confirmação)

Em pastas:

• Abrir — navegar para dentro da pasta
• Excluir — excluir a pasta recursivamente (com confirmação)

Em espaço vazio:

• Upload, Nova Pasta, Novo Arquivo, Adicionar Link, Clonar Repositório

Painel de Visualização de Arquivo

Ao clicar em um arquivo, um painel lateral abre mostrando:

• Caminho e metadados do arquivo (tamanho, data de modificação)
• Conteúdo com realce de sintaxe para arquivos de texto
• Botão de fechar (X) ou clique fora para dispensar

6. Worker Studio — Workers Personalizados

Você pode criar workers de IA personalizados adaptados às necessidades do seu projeto.

Criando um Worker

1. No Workspace, clique no ícone de engrenagem (Worker Studio) na barra de workers
2. Clique em + Novo Worker
3. Preencha a configuração do worker:

System Prompts Gerados por IA

Clique em Gerar com IA para criar automaticamente um system prompt com base em:

• Label e tipo do worker
• Ferramentas selecionadas
• Diretórios de foco
• Estrutura do seu projeto

Token do Bot Telegram

Cada worker pode ter seu próprio bot Telegram dedicado:

1. Edite um worker no Worker Studio
2. Na seção Telegram Bot Token, cole um token de bot (obtido no @BotFather)
3. Clique em Conectar
4. O bot do worker inicia automaticamente e lida com mensagens de forma independente
5. Para remover: clique em Desconectar

Isso permite bots Telegram por worker — ex.: um bot Consultant com acesso somente leitura e um bot Developer com acesso total.

Gerenciando Workers

• Editar: Clique no ícone de edição em qualquer worker personalizado no Worker Studio
• Excluir: Clique no ícone de exclusão (workers nativos não podem ser excluídos)
• Os workers são armazenados no registro de workers do servidor

7. Issues

A página Issues é um rastreador de issues completo para seu projeto.

Funcionalidades

• Crie issues com título, descrição, prioridade (P0-P3) e labels
• Fluxo de status: Open → In Progress → Done / Closed
• Log de atividades: Adicione notas de progresso a qualquer issue via o formulário de entrada de log
• Filtre por status (open, closed, all)
• Pesquise issues por texto

Pelo ARC CLI

As issues também podem ser gerenciadas via ARC CLI:

arc issues                         # listar issues abertas
arc issue create --title "Bug..." # criar nova issue
arc issue log <id> "Corrigido X"  # adicionar entrada no log de atividades

8. Wiki

A página Wiki é a base de conhecimento do seu projeto.

Funcionalidades

• Crie páginas com título e conteúdo em markdown
• Edite páginas existentes com o editor de markdown integrado
• Sincronização automática com o NotebookLM para busca semântica (se configurado)
• As páginas são armazenadas por projeto no servidor

9. Knowledge Graph

A página Graph visualiza os relacionamentos entre as entidades do projeto (issues, páginas wiki, skills, phases do roadmap) como um grafo de nós interativo.

• Os nós representam diferentes tipos de entidade (codificados por cor)
• As arestas mostram os relacionamentos entre as entidades
• Clique em um nó para ver os detalhes
• Arraste para mover, role para ampliar/reduzir

10. Skill Evolution

A página Skill Evolution (chamada "Skills" na sidebar do projeto, "Skills Registry" na sidebar global) oferece gerenciamento avançado de skills.

Layout em Dois Painéis

• Painel esquerdo: Explorador de skills — lista de todas as skills com busca/filtro
• Painel direito: Detalhes da skill com 4 abas:
  • Overview — descrição, metadados e histórico de versões da skill
  • Evals — regras de validação de qualidade
  • Evolution — log de alterações e histórico de versões
  • Benchmarks — resultados de testes A/B

Sage Worker

O Sage é um analisador de skills baseado em IA:

• Analisar: Selecione uma skill → clique em "Sage Analyze" → obtenha recomendações de melhoria
• Benchmark: Execute testes A/B comparando versões de skills
• Marketplace Discovery: Pesquise skills da comunidade em claudemarketplaces.com → analise compatibilidade → instale globalmente ou por projeto

Forks de Skills

Faça fork de uma skill global para personalizá-la para um projeto específico. O fork rastreia a skill pai e pode receber atualizações.

11. Roadmap

A página Roadmap mostra o plano de desenvolvimento do projeto organizado por phases.

• Veja phases concluídas, em andamento e planejadas
• Cada phase tem uma descrição e status
• Sincronizado via o comando CLI arc roadmap sync

12. Relatórios

A página Relatórios mostra analytics e relatórios de sessões.

• Veja relatórios de sessões anteriores enviados via arc report
• Acompanhe o trabalho realizado por sessão

13. Analytics

A página Analytics (visão global) mostra métricas e saúde do sistema:

• Cards de status dos projetos com indicadores de saúde
• Visão geral do sistema com dados de uptime e desempenho

14. NotebookLM — Memória Neural

Se o seu projeto tiver notebooks NotebookLM vinculados, eles aparecem no rodapé da sidebar em "Neural Memory":

• Ponto verde = sincronizado, com contagem de fontes
• Clique para abrir o notebook no Google NotebookLM
• Sincronizado automaticamente quando issues são criadas/encerradas e páginas wiki são atualizadas

A página global NotebookLMs mostra todos os notebooks vinculados entre os projetos.

15. Cloud PM — Chat do Projeto

O Cloud PM é um chat persistente do projeto acessível no Workspace:

• Interface de chat com Claude (Anthropic API)
• Mensagens salvas no banco de dados com paginação baseada em cursor
• Separado das conversas com workers — usado para discussões de gerenciamento de projetos
• O histórico persiste entre sessões

16. Configurações do Projeto

A página Configurações do Projeto (acessível pelo botão Configurações na sidebar) oferece:

• Informações do projeto: nome de exibição, descrição
• Telegram Bot Token: Conectar um bot Telegram no nível do projeto (obtido no @BotFather)
• Presets de equipe: Configurar a composição da equipe e os padrões de workers
• Zona de perigo: remoção do projeto

17. Integração com Telegram

O bot Telegram é uma interface de comando alternativa. Todas as funcionalidades do dashboard CRM também são acessíveis via Telegram.

Comandos do Master Bot

Comandos do Child Bot

Roteamento de Mensagens

Bots Telegram por Worker

Cada worker pode ter seu próprio token de bot Telegram (configurado no Worker Studio). Quando um worker tem seu próprio bot:

• Mensagens enviadas para aquele bot vão diretamente para aquele worker
• Nenhum prefixo /c ou /d necessário
• As respostas aparecem tanto no Telegram quanto no CRM

Botões Inline

Após cada resposta do bot, botões inline aparecem:

• Stop — encerrar subprocesso atual
• Pause / Resume — congelar/descongelar subprocesso
• BTW — enfileirar contexto adicional para a próxima mensagem
• Fix It — re-executar com o prompt "corrigir a resposta anterior"
• Polegar para cima/baixo — feedback de qualidade (treina o sistema de aprendizado)

18. Tema e Configurações

Modo Claro/Escuro

Clique no alternador de tema no header superior para alternar entre os temas claro e escuro. Sua preferência é salva no localStorage.

Configurações da Conta

Clique no seu avatar → Configurações da Conta para configurar:

• Nome de exibição
• Preferência de idioma (Inglês / Ucraniano)
• Configurações de notificação

Sistema de Cores

O dashboard usa propriedades CSS customizadas para temas consistentes:

• Modo claro: fundos brancos limpos, bordas sutis
• Modo escuro: fundos em ardósia escura, texto suavizado

Cores de Status

19. Atalhos de Teclado

20. Solução de Problemas

"Conexão perdida" / Indicador vermelho

O dashboard perdeu a conexão com o servidor. Verifique:

1. O VPS está rodando? (acesse via ssh e verifique tmux ls)
2. O nginx está rodando? (systemctl status nginx)
3. O master bot está rodando? (curl http://<servidor>:19210/api/master/health)

"Unauthorized" / Loop de login

Seu token JWT expirou (TTL de 24h). Faça login novamente via email/senha ou OAuth.

Painel do worker não mostra saída

1. Verifique que o stream SSE está conectado (DevTools do navegador → Network → filtrar por EventStream)
2. O worker pode ainda não ter produzido saída — envie uma mensagem primeiro
3. Tente atualizar a página (F5)

Upload de arquivo falhou

• Verifique o tamanho do arquivo (texto < 512KB, imagens são comprimidas automaticamente, PDFs < 10MB recomendado)
• Certifique-se de que o tipo de arquivo é suportado (veja Anexos de Arquivo)
• Verifique o console do navegador por erros

Bot não responde no Telegram

1. Verifique a saúde do bot: envie /ping
2. Sem resposta? Acesse o VPS via SSH e verifique o tmux: tmux attach -t citadel-child
3. Verifique os logs: tail -50 /var/log/citadel/<projeto>/system-$(date +%Y-%m-%d).log
4. Reinicie pelo CRM: Configurações do Projeto → Restart Bot, ou /deploy no Master Bot

Erros de CORS no console do navegador

O domínio do dashboard deve estar em CRM_ALLOWED_ORIGINS. Padrões permitidos:

• https://arc-os.co
• http://localhost:5173 (dev)
• http://62.171.128.248:18888 (produção)

invite_required 403 no cadastro (Phase 52.1)

O cadastro público está restrito. Você pode:

• Obter um código de convite de um Founding Member ou no canal @arcos_beta_feedback
• Código revogado? Fale diretamente com o CEO (DM); a revogação é registrada na tabela invites

plan_limit_reached 402 ao criar projeto / worker (Phase 51)

Sua conta atingiu o limite do seu plano:

• Free — 1 projeto / 5 workers
• Min ($4,99/mês) — 5 OU 25 (semântica OR)
• Max ($11,99/mês) — 20 OU 150
• Beta — ilimitado (atribuído manualmente aos testers F&F)

Faça upgrade em Configurações → Billing (a UI Stage 3 está em desenvolvimento). Por enquanto, entre em contato com o CEO.

21. Timeline (Phase 47)

Uma página de observabilidade no estilo DAW que permite reproduzir a sessão de um worker como se fosse um console de mixagem de áudio.

sequenceDiagram
    participant U as You
    participant W as Workspace
    participant T as Timeline
    participant DB as timeline_events table

    U->>W: send message to Worker A
    W->>DB: append events (think · tool · response)
    U->>T: open Timeline page
    T->>DB: query events grouped by worker
    T-->>U: render lanes + playhead
    U->>T: scrub playhead / mute/solo lanes

Funcionalidades

• Worker lanes — uma linha por worker ativo, como áudio multipista
• Event chips — codificados por cor: thinking (roxo), chamadas de ferramentas (azul), respostas (verde), erros (vermelho)
• Mute / Solo (M/S) — ocultar um worker ou isolá-lo; persistido no localStorage
• Playhead scrubbing — arraste para um momento no tempo; os eventos são destacados à medida que você passa
• Desempenho — apoiado pela tabela SQLite timeline_events (migration 014); timestamps em milissegundos

Quando usar

• Depurar um worker travado — veja exatamente qual chamada de ferramenta travou
• Auditar uma sessão longa — encontre rapidamente quando uma decisão crítica foi tomada
• Demonstrar o sistema — prova visual de que os workers realmente fazem o trabalho

22. Créditos do Período Gratuito e Billing (Phases 50-51)

O Arc OS usa a API da Anthropic em seu nome para workers de chat/terminal. A plataforma base é gratuita, mas os custos de tokens são repassados para sua conta.

Créditos do Período Gratuito (Phase 50)

• Período gratuito — cada novo email recebe uma cota de créditos única (rejeitada se o email já foi utilizado)
• Sem cartão — nenhum cartão de crédito é necessário para começar; os créditos diminuem conforme os workers executam
• Tabela trial_credits — indexada por email, nunca recarregada com upgrade

Stripe Billing (Phase 51 — Stage 1 ativo, UI Stage 3 pendente)

Limites com semântica OR: "5 OU 25" significa que você pode ter ≤5 projetos OU ≤25 workers em todos os projetos — o que for atingido primeiro.

Usando sua própria chave

Se preferir pagar à Anthropic diretamente:

1. Obtenha uma chave de API da Anthropic em https://console.anthropic.com
2. Configurações da Conta → API Keys → cole a chave
3. Ou use o ARC CLI Local Bridge para executar workers na sua própria máquina gratuitamente

Endpoint de status

GET /api/crm/billing/status retorna:

• Plano atual + preço
• Snapshot de uso (projetos, workers, gasto com Anthropic)
• Limites do plano + quantidade restante
• Feature flags (quais funcionalidades premium estão habilitadas)

23. Acesso Beta — Códigos de Convite (Phase 52.1)

O Arc OS está em beta Friends & Family. O cadastro público está fechado até que os critérios de sucesso do F&F sejam validados.

Obtendo um convite

• De um Founding Member — qualquer pessoa com um código de convite ativo pode gerar sub-convites
• Do canal Telegram @arcos_beta_feedback — lotes periódicos distribuídos pelo CEO
• Pedido direto — envie uma DM ao CEO se você tiver um caso de uso relevante

Formato do código

arc-XXXX-XXXX — prefixo arc- + 8 caracteres hex em dois grupos separados por hífen (derivado de crypto.randomBytes).

Usando um código

1. Acesse o formulário de cadastro
2. Cole o código no campo Invite Code (entrada monoespaçada, validada no lado do cliente)
3. O código é consumido atomicamente no cadastro bem-sucedido — um código por conta
4. Se o código já foi usado ou foi revogado: 403 invite_required com link de volta ao canal de feedback

Benefícios de Founding Member

• 50% de desconto vitalício quando o lançamento público acontecer
• Badge de Founding Member no perfil (perfil público)
• Acesso direto ao Slack/Discord da equipe Arc OS após o lançamento
• Nome no Founders Wall público em https://arc-os.co/founders (opt-in)

Admin: geração e revogação de códigos (somente CEO)

arc invites generate --count 5            # gerar 5 novos códigos
arc invites list                          # exibir códigos ativos + quem os usou
arc invites revoke arc-AAAA-BBBB          # invalidar um código vazado

Equivalentes REST: POST/GET/DELETE /api/crm/admin/invites (role admin necessária).

Mantido pela equipe Arc OS. Atualizado após cada conclusão de phase.