Docs/Configuração

Configuração

FreePro: Cloud Sync, temas e fontes premium, Swarmcode

Toda a configuração do Pocket Code centralizada em um só lugar. As configurações são divididas em 10 sub-modelos (Editor, App, AI, Project, Session Backup, Sync, Keybindings, Proxy, Dashboard, Accessibility) persistidos no dispositivo.

Tela principal — 13 seções

A tela de Settings organiza cada controle em seções recolhíveis que compartilham os mesmos componentes de linha.

Account

Manage account → navega até o perfil do usuário.

Appearance

Theme mode (System / Light / Dark) · Idioma.

Provider select · API Keys · Tool Permissions · MCP Servers · Auto Suggestions · Code Completion · Contextual Help.

Integrations

Connected Services (GitHub, Vercel, Supabase…).

Compiladores / Runtimes

Plugin Manager (Python WASM, Ruby, Lua, Go, Rust, C++ Clang…).

Editor

Editor theme · Terminal theme · Font family · Font size · Tab size · Autosave · Números de linha · Realce de sintaxe · Auto indent · Word wrap · Code folding · Formatter · Minimap · Find & Replace · Barra de status · Caracteres invisíveis.

Projects

Auto backup · Cloud Sync · Compressão · Pasta de download.

Behavior

Feedback tátil · Reduzir movimento · Transições de navegação · Notificações · Confirmar antes de excluir · Limpar cache · Restaurar padrões.

Advanced Tools

Session Backup · Settings Sync · Keybindings · HTTP Proxy · Dashboard Widgets · Acessibilidade.

Privacy

Analytics · Relatórios de falhas · Monitoramento de desempenho · Info de coleta de dados · Excluir meus dados (GDPR).

About

Versão do app · Créditos · Licenças · Termos e Condições · Opções de desenvolvedor.

Premium Banner

Fazer upgrade / Gerenciar assinatura.

Diálogos

API Keys · Tool Permissions · MCP Servers · Backup · Sync · Keybindings · Proxy · Dashboard Widgets · Acessibilidade · Licenças · Reset · Coleta de dados · Excluir dados.

Provedores de IA e API Keys

Todos os provedores funcionam sob BYOK (Bring-Your-Own-Key) ou login OAuth. O Pocket Code não é um provedor de IA e não faz proxy das requisições: as chamadas vão direto do dispositivo ao provedor usando sua conta ou key. As API keys são criptografadas no dispositivo. OAuth está disponível para Claude (Claude Code CLI), Codex/OpenAI (Codex CLI) e Gemini (Gemini CLI) — com refresh automático de tokens; o Copilot usa o OAuth Device Flow do GitHub.

Provider	Auth	Plan
OpenAI	API key manual ou OAuth via Codex CLI	Pro
Gemini	API key manual ou OAuth via Gemini CLI	Free
Claude	API key manual ou OAuth via Claude Code CLI	Pro
GitHub	OAuth Device Flow (Copilot e integrações)	Pro
Copilot LSP	Derivado do token do GitHub	Pro

Os insights do provedor abrem três abas por provedor: Uso (gráfico de tokens), Top modelos (ranking por consumo) e Configurações (overrides de temperature, maxTokens, topP, topK, thinkingBudget, frequencyPenalty, presencePenalty, copilotCategory, mcpEnabled, maxAgenticRounds).

Tool Permissions

Controla quais ferramentas cada provedor de IA pode invocar (no provedor inteiro ou por modelo específico). As decisões são aplicadas em cada camada do stack de IA.

•Chips de provedor: OpenAI / Gemini / Claude / Copilot
•Scope dropdown: no provedor inteiro ou modelo específico (gpt-4.1, claude-sonnet-4…)
•Switch binário para todo o LSP do Copilot
•Lista recolhível por categoria com contador N / M allowed
•Ações Allow all / Deny all por categoria

MCP Servers

Servidores Model Context Protocol configurados pelo usuário. Cada servidor define ID, display name, command (node ou npx, whitelist de segurança), args e env vars. Os servidores são montados automaticamente quando o chat precisa deles.

Idle

Starting

Running · N tools

Failed

Disabled

Sincronização na nuvem

Pro

O serviço de sync orquestra pull/push contra o backend. Triggers automáticos: sign-in, rede restaurada, mudança de configuração (debounce de 2 s), app em segundo plano e manual.

12 grupos sincronizáveis

Settings

Snippets

Keybindings

Themes (off default)

Connections

Stats

Schemas

API Collections

Extensions

Workflows

Designs

AI Conversations

Resolução de conflitos: LOCAL_WINS · REMOTE_WINS · ASK (padrão) · MERGE.

Session Backup

Snapshots periódicos do estado do editor (abas abertas, posição do cursor, undo stack, arquivos não salvos) que sobrevivem a crash ou force-close. Restaurados ao abrir o app.

Toggle mestre

Ativa ou desativa todo o sistema.

Intervalo

FREQUENT (5 min) · NORMAL (15 min) · MODERATE (30 min) · HOURLY (60 min)

Máx. backups

Slider de 1–50. Rotação FIFO ao exceder.

Incluir não salvos

Inclui o buffer dirty não salvo.

Backup ao fechar

Snapshot extra ao ir para segundo plano.

Backup Now

Acionamento manual a partir do diálogo.

Keybindings personalizáveis

29 atalhos padrão em 7 categorias (Editor, Navigation, File, Search, Terminal, Debug, General). Presets disponíveis: Default, VSCode, IntelliJ, Sublime, Atom, Custom.

saveCtrl+S

save_allCtrl+Shift+S

undoCtrl+Z

redoCtrl+Shift+Z

findCtrl+F

replaceCtrl+H

command_paletteCtrl+Shift+P

quick_openCtrl+P

goto_lineCtrl+G

toggle_terminalCtrl+`

toggle_sidebarCtrl+B

comment_lineCtrl+/

duplicate_lineCtrl+Shift+D

move_line_upAlt+Up

move_line_downAlt+Down

toggle_breakpointF9

start_debugF5

step_overF10

HTTP proxy

Proxy global aplicado a todo o tráfego HTTP do app. Suporta 4 protocolos: HTTP (8080), HTTPS (443), SOCKS4 (1080), SOCKS5 (1080).

•Auth opcional (usuário + senha)
•Bypass list (padrão: localhost, 127.0.0.1) — respeitada para tooling interno
•Use system proxy: usa o proxy configurado no Android
•Botão Test connection (GET dummy para https://example.com)

Dashboard widgets

Personalização da tela inicial. 10 tipos de widget reordenáveis (drag handle) e ativáveis individualmente. Os primeiros 5 ativos por padrão.

RECENT_FILES

Acesso rápido a arquivos recentes

PROJECT_STATS

Linhas de código, contagem de arquivos…

GIT_STATUS

Branch atual, alterações pendentes

TODO_LIST

TODOs pendentes do código

BUILD_STATUS

Resultado e duração do último build

AI_SUGGESTIONS

Sugestões contextuais de IA

TERMINAL_QUICK

Comandos de terminal com um clique

BOOKMARKS

Posições de arquivo salvas

PERFORMANCE

Uso de memória e CPU

MARKETPLACE

Pacotes em destaque e atualizações

Acessibilidade

Navegação por teclado

Interruptor mestre para navegar pelo app com o teclado.

Indicadores de foco

Anel visível nos componentes em foco.

Ordem de navegação com Tab

Respeita a ordem Tab → Tab para foco sequencial.

Navegação por teclas de seta

As setas movem entre os itens.

Escape para voltar

Esc fecha diálogos / volta atrás.

Otimizado para leitor de tela

Labels extras para o TalkBack.

Foco de alto contraste

Anel de foco de alto contraste.

Cor do indicador de foco

Seletor de cor para o anel de foco (padrão #2196F3).

Privacidade e biometria

Toggles de privacidade

• Analytics (Firebase Analytics)
• Crash reporting (Crashlytics)
• Performance monitoring (combinação dos dois)
• Exclusão de dados GDPR (sign-out + reinício)

Autenticação biométrica

• BIOMETRIC_STRONG (impressão digital, face unlock)
• DEVICE_CREDENTIAL (PIN/padrão/password) — API 30+
• Telas protegidas: API Keys, Integrations

Reversão Premium ao expirar

Quando a assinatura expira, as configurações exclusivas do premium voltam aos padrões do Free. Os dados do usuário (projetos, designs, conexões, stats, conversas de IA, API keys) NÃO são excluídos.

Setting	Volta para
editorSettings.editorTheme	"VS Code Dark+"
editorSettings.fontFamily	DEFAULT
aiSettings.selectedProvider	GEMINI
projectSettings.cloudSync	false
syncConfig.enabled	false

Período de carência: 7 dias por padrão, durante os quais o plano permanece como Pro mesmo tendo expirado.

Plano Free vs Pro

Funcionalidade	Plan
Tema do editor (dark/light integrado)	Free
Temas premium do marketplace (20+)	Pro
Fontes premium (JetBrains Mono, Fira Code…)	Pro
Cloud sync (settings, snippets, temas, etc.)	Pro
API key Gemini	Free
API keys OpenAI / Claude / Copilot / GitHub	Pro
Permissões de ferramentas	Free
MCP servers	Free
Session backup	Free
Keybindings personalizados	Free
HTTP proxy	Free
Dashboard widgets	Free
Acessibilidade	Free
Exportar/importar settings (JSON)	Free
Autenticação biométrica	Free

Estatísticas do módulo

Sub-modelos de Settings

Seções de UI

Keybindings default

Grupos de cloud sync

Dashboard widgets

Toggles de acessibilidade

Provedores de IA

Protocolos de proxy

Perfil