Docs/Configuration

Configuration

FreePro: Cloud Sync, premium themes and fonts, premium AI providers

All of Pocket Code's configuration centralized in one place. Settings are split into 10 sub-models (Editor, App, AI, Project, Session Backup, Sync, Keybindings, Proxy, Dashboard, Accessibility) persisted on-device.

Main screen — 13 sections

The Settings screen organizes every control into collapsible sections sharing the same row components.

Account

Manage account → navigates to the user profile.

Appearance

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

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

Integrations

Connected Services (GitHub, Vercel, Supabase…).

Compilers / Runtimes

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

Editor

Editor theme · Terminal theme · Font family · Font size · Tab size · Autosave · Line numbers · Syntax highlighting · Auto indent · Word wrap · Code folding · Formatter · Minimap · Find & Replace · Status bar · Invisible chars.

Projects

Auto backup · Cloud Sync · Compression · Download folder.

Behavior

Haptic feedback · Reduce motion · Navigation transitions · Notifications · Confirm before delete · Clear cache · Reset to defaults.

Advanced Tools

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

Privacy

Analytics · Crash reports · Performance monitoring · Data collection info · Delete my data (GDPR).

About

App version · Credits · Licenses · Terms & Conditions · Developer Options.

Premium Banner

Upgrade / Manage Subscription.

Dialogs

API Keys · Tool Permissions · MCP Servers · Backup · Sync · Keybindings · Proxy · Dashboard Widgets · Accessibility · Licenses · Reset · Data Collection · Delete Data.

AI providers and API Keys

All providers run under BYOK (Bring-Your-Own-Key) or OAuth login. Pocket Code is not an AI provider and does not proxy requests: calls go directly from the device to the provider using your account or key. API keys are encrypted on-device. OAuth is available for Claude (Claude Code CLI), Codex/OpenAI (Codex CLI) and Gemini (Gemini CLI) — with automatic token refresh; Copilot uses GitHub's OAuth Device Flow.

Provider	Auth	Plan
OpenAI	Manual API key or OAuth via Codex CLI	Pro
Gemini	Manual API key or OAuth via Gemini CLI	Free
Claude	Manual API key or OAuth via Claude Code CLI	Pro
GitHub	OAuth Device Flow (Copilot and integrations)	Pro
Copilot LSP	Derived from GitHub token	Pro

Provider insights open three tabs per provider: Usage (token chart), Top models (consumption ranking) and Settings (overrides for temperature, maxTokens, topP, topK, thinkingBudget, frequencyPenalty, presencePenalty, copilotCategory, mcpEnabled, maxAgenticRounds).

Tool Permissions

Controls which tools each AI provider can invoke (provider-wide or per specific model). Decisions are enforced at every layer of the AI stack.

•Provider chips: OpenAI / Gemini / Claude / Copilot
•Scope dropdown: Provider-wide or specific model (gpt-4.1, claude-sonnet-4…)
•Binary switch for entire Copilot LSP
•Collapsible per-category list with N / M allowed counter
•Allow all / Deny all per category actions

MCP Servers

User-configured Model Context Protocol servers. Each server defines ID, display name, command (node or npx, security whitelist), args and env vars. Servers are mounted automatically when the chat needs them.

Idle

Starting

Running · N tools

Failed

Disabled

Cloud sync

Pro

Sync orchestrates pull/push against the backend. Auto triggers: sign-in, network restored, setting change (2s debounce), app background and manual.

12 syncable groups

Settings

Snippets

Keybindings

Themes (off default)

Connections

Stats

Schemas

API Collections

Extensions

Workflows

Designs

AI Conversations

Conflict resolution: LOCAL_WINS · REMOTE_WINS · ASK (default) · MERGE.

Session Backup

Periodic snapshots of editor state (open tabs, cursor position, undo stack, unsaved files) that survive crash or force-close. Restored on app open.

Master toggle

Enables or disables the whole system.

Interval

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

Max backups

1–50 slider. FIFO rotation when exceeded.

Include unsaved

Includes unsaved dirty buffer.

Backup on close

Extra snapshot on background.

Backup Now

Manual trigger from the dialog.

Custom keybindings

29 default shortcuts in 7 categories (Editor, Navigation, File, Search, Terminal, Debug, General). Available presets: 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

Global proxy applied to all HTTP traffic from the app. Supports 4 protocols: HTTP (8080), HTTPS (443), SOCKS4 (1080), SOCKS5 (1080).

•Optional auth (username + password)
•Bypass list (default: localhost, 127.0.0.1) — respected for internal tooling
•Use system proxy: uses Android's configured proxy
•Test connection button (dummy GET to https://example.com)

Dashboard widgets

Home screen customization. 10 widget types reorderable (drag handle) and toggleable individually. First 5 active by default.

RECENT_FILES

Quick access to recently opened files

PROJECT_STATS

Lines of code, file count…

GIT_STATUS

Current branch, pending changes

TODO_LIST

Pending TODOs from code

BUILD_STATUS

Last build result and duration

AI_SUGGESTIONS

Contextual AI suggestions

TERMINAL_QUICK

One-click terminal commands

BOOKMARKS

Saved file locations

PERFORMANCE

Memory and CPU usage

MARKETPLACE

Featured packages and updates

Accessibility

Keyboard navigation

Master switch to navigate the app with the keyboard.

Focus indicators

Visible ring on focused components.

Tab navigation order

Respects Tab → Tab order for sequential focus.

Arrow key navigation

Arrow keys move between items.

Escape to go back

Esc closes dialogs / goes back.

Screen reader optimized

Extra labels for TalkBack.

High contrast focus

High-contrast focus ring.

Focus indicator color

Color picker for the focus ring (default #2196F3).

Privacy and biometrics

Privacy toggles

• Analytics (Firebase Analytics)
• Crash reporting (Crashlytics)
• Performance monitoring (both combined)
• GDPR data deletion (sign-out + restart)

Biometric authentication

• BIOMETRIC_STRONG (fingerprint, face unlock)
• DEVICE_CREDENTIAL (PIN/pattern/password) — API 30+
• Gated screens: API Keys, Integrations

Premium revert on expiry

When the subscription expires, premium-only settings revert to free defaults. User data (projects, designs, connections, stats, AI conversations, API keys) is NOT deleted.

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

Grace period: 7 days by default during which the plan stays as Pro even though it has expired.

Free vs Pro plan

Feature	Plan
Editor theme (built-in dark/light)	Free
Premium marketplace themes (20+)	Pro
Premium fonts (JetBrains Mono, Fira Code…)	Pro
Cloud sync (settings, snippets, themes, etc.)	Pro
Gemini API key	Free
OpenAI / Claude / Copilot / GitHub API keys	Pro
Tool permissions	Free
MCP servers	Free
Session backup	Free
Custom keybindings	Free
HTTP proxy	Free
Dashboard widgets	Free
Accessibility	Free
Settings export/import (JSON)	Free
Biometric authentication	Free

Module statistics

Settings sub-models

UI sections

Keybindings default

Cloud sync groups

Dashboard widgets

Accessibility toggles

AI providers

Proxy protocols

Profile