Skip to content
Home
Docs/Settings

Settings

Settings is the control panel of the app: 15 sections and a search box covering appearance, the editor, notifications, session backup, Cloud Sync, keyboard shortcuts, accessibility, privacy and support. Free and Pro see the same screen; Pro themes, Pro fonts, Cloud Sync and Backend Manager notifications need Pro. AI keys and models have their own page, and a few options are saved but do nothing today: they are marked in each section and in Limitations.

What it is and how to open it

Settings opens as a full-screen window above whatever you were doing. On a phone it is a single column with a search box; on a tablet it is split in two, with the sections on the left and the one you pick on the right. When Settings was opened from another screen (the editor, for example), going back returns you there.

Ways to open it

FromWhat happens
The gear button of the bottom bar (phone) or of the side rail (tablet)Opens Settings. The button is announced as Open settings by screen readers.
Home: the Settings quick action and the AI providers lineBoth open Settings. Settings is one of the quick actions you can choose in Configure widgets.
The command palette: App SettingsWorks from any screen. With a hardware keyboard, Ctrl+Shift+P opens the palette, and Ctrl+P does too outside the editor.
The chat's Edit API key actionWhen a key is missing or rejected, the chat sends you to the API keys sheet of Settings, on that provider's row. This path does not ask for your fingerprint (see Biometrics).

How the screen works

  • Search. Search settings filters every row as you type: each word has to appear in the row's title, description or keywords (capitals and accents are ignored), and a section whose name matches is shown whole. A counter says how many settings match, and a message appears when none does.
  • Pro banner. At the top there is a banner in the Pro design. On Free it reads Support PocketCode · Pro and opens the Pro screen; during a trial it reads PocketCode Pro trial; if Google Play reports a payment problem it says so and takes you to Play; with a paid Pro it becomes a thank-you card with Manage subscription. It is hidden while you search.
  • Per account. Your settings are stored on the device for the account you are signed in with. A second account on the same phone starts with its own settings and cannot read yours.
  • Secure window. Android blocks screenshots and screen recordings of Settings, which is why this page has no screenshots.
  • Developer Options. A sixteenth section exists only in debug builds of the app and is not covered here.

You can't, and why

  • Open a section or a sheet from a link: there is no pocketcode:// link for Settings.By design
  • Take a screenshot or a screen recording of Settings.By design

Screen map

Settings has 15 sections, in this order, plus the sheets and dialogs they open and the screens they hand you to. Phone and tablet list the same sections.

The 15 sections

ScreenHow you reach itWhat you can do there
AccountSection 1One row, Manage Account, that opens your profile.
AppearanceSection 2App theme and language, the Editor appearance and Terminal appearance sheets, Navigation transition, Reset editor hints and Replay the tour.
AISection 3Keys, models, tool permissions, MCP servers, secrets and a few AI switches. Summarised here, covered on the AI page.
IntegrationsSection 4Connected Services, behind a biometric check.
Compilers and runtimesSection 5Additional language runtimes: opens the Plugin manager.
Editor · writingSection 6Tab size, autosave, auto indent, word wrap and the code formatter button.
Editor · viewSection 7Fourteen controls: line numbers, minimap, breadcrumb, column guide, ligatures, line spacing, color swatches, inlay hints and more.
ProjectSection 8Create automatic backup and File compression.
BehaviorSection 9Vibration, Reduce motion and Confirm before deleting.
NotificationsSection 10A summary row that opens its own Notifications screen.
TerminalSection 11Terminal auto-reconnect.
MaintenanceSection 12Clear cache and Reset to defaults.
Advanced ToolsSection 13Session Backup, Settings & data sync, Keybindings, Dashboard Widgets and Accessibility.
PrivacySection 14Three switches (Allow analytics, Crash reports, Anonymous statistics), What data we collect and Delete my account and data.
AboutSection 15Report a bug, version, rate, share, feedback, licenses and the legal links.

On a tablet the sections are a list on the left and only the chosen one shows on the right; while you search, every matching section shows and the list dims.

Sheets, dialogs and hand-offs

ScreenHow you reach itWhat you can do there
Editor appearanceAppearance › Editor appearanceEditor theme, font, size and background image, with a live code sample. It has a Themes gallery.
Terminal appearanceAppearance › Terminal appearanceTerminal theme, font, size and background image, with a color sample.
Notifications screenNotifications rowMaster switch, Android permission, quiet hours and per-module switches. Back returns to Settings.
Quiet hours sheetNotifications › Quiet hoursA switch, From and To times and Let "Monitor down" through.
Module pagesNotifications › By moduleOne switch for each notification type of AI Office, Workflows, Cortex and News and updates.
Session Backup dialogAdvanced Tools › Session BackupInterval, number of copies, Backup Now and the list of saved copies with Restore.
Settings Sync dialogAdvanced Tools › Settings & data syncEnable Sync (Pro), what to sync, conflict handling and Sync Now.
Keybindings dialogAdvanced Tools › KeybindingsFive keymaps and 26 editable shortcuts, with search, categories and duplicate warnings.
Accessibility dialogAdvanced Tools › AccessibilityFocus outline switches and color, and Escape to Go Back.
Configure widgets (on Home)Advanced Tools › Dashboard WidgetsCloses Settings and opens the widget sheet of Home.
Data We Collect dialogPrivacy › What data we collectRead the five categories of data the app handles.
Delete my account and data dialogPrivacy › Delete my account and dataType a confirmation word, verify, and delete the account and its cloud data.
Report a bug sheetAbout › Report a bug or Send feedbackSend a bug, suggestion or other note with masked diagnostics.
Open source licensesAbout › Open source licensesSearch the third-party components and read each license, plus the required legal notices.
Pro wallsChoosing a Pro theme or font, or switching on Enable SyncA Pro sheet that explains the feature and leads to the Pro screen.
Profile, Connected Services, Plugin manager, Backend Manager notifications, tourRows of Account, Integrations, Compilers and runtimes, Notifications and AppearanceSettings closes and the other screen opens; going back returns to Settings (not after the tour or Dashboard Widgets, which end on Home).

Account

The first group has a single row.

You can

  • Tap Manage Account (“Manage profile, messages and friends”) to leave Settings and open your profile. Going back from the profile returns to Settings.
  • Everything about your identity (alias, bio, avatar, linked sign-in methods, two-factor sign-in, signing out and deleting the account from the profile) lives in the profile, not in Settings.

You can't, and why

—

Appearance, language and tour

This section sets how the app looks and moves. Colors, fonts and background images for the editor and the terminal live in two sheets that open from here.

You can

  • Choose Theme: System, Light or Dark. It applies at once and is kept for the next start.
  • Choose Language: System Default, English, Español, Português or 中文. The screen restarts to apply it. The app has no Hindi interface.
  • Open Editor appearance and Terminal appearance. Each row shows the current values, for example “Same as app · Default · 14sp”.
  • Choose Navigation transition, the animation between pages of the main screen: Slide, Vertical, Fade, Scale, Slide+Fade (default), Material or Parallax. Reduce motion shortens it.
  • Tap Reset editor hints to show again the first-use tips of the editor (command key, palette, multiple cursors, zen, explorer) and the terminal gestures.
  • Tap Replay the tour to close Settings, go to Home and start the 30-second app tour again.

You can't, and why

  • Use a language other than English, Spanish, Portuguese or Chinese.By design

Editor appearance sheet

A full-height sheet that opens with a code sample in the current theme. Everything below changes the sample at once, so you choose by looking.

You can

  • Browse Theme in the carousel, or tap See all for the Themes gallery with the filters All, Dark, Light and Included. Its header says how many themes there are and how many are included.
  • Same as app (the default) makes the editor follow the light or dark theme of the app. Four more themes are included: PocketCode Dark, PocketCode Light, VS Code Dark+ and GitHub Light. Themes installed from the Marketplace join the same list.
  • Pick Font among eight options: Default (the system monospace font) and seven Pro fonts: JetBrains Mono, Fira Code, Source Code Pro, Cascadia Code, Roboto Mono, Ubuntu Mono and Inconsolata.
  • Change Size with the minus and plus buttons: four steps, 12sp, 14sp (default), 16sp and 18sp.
  • Choose a Background image with Choose (the photo picker, images only). The first time, opacity drops to 55% so the picture shows through; change it with Background opacity (30% to 100%) and remove the picture with Remove background image.

You can't, and why

  • Use one of the 19 Pro themes, or any font other than Default, on the Free plan: a Pro sheet opens instead.Pro
  • Choose a size between the four steps.By design

Terminal appearance sheet

The same layout as the editor sheet, with a sample of the terminal's ANSI colors instead of code.

You can

  • Pick Theme among twelve: Same as app (default), PocketCode Dark, PocketCode Light, Dark and Light are included; seven more need Pro: Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark and Nord.
  • Pick Font (the same eight, all Pro except Default) and Size from 9sp to 20sp in steps of 1sp.
  • Choose a Background image and Background opacity (30% to 100%) exactly as in the editor.
  • Terminal size, font, opacity and picture are stored apart from the other settings: Reset to defaults does not touch them (it does put the terminal theme back to Same as app), and Cloud Sync carries none of the terminal appearance.

You can't, and why

  • Use a Pro terminal theme or font on the Free plan: a Pro sheet opens instead.Pro

AI keys and models

The AI section is where the chat, the editor and the background AI tasks get their keys and models. Adding your own provider keys is free on every plan. This page only lists the rows; each one is explained on the AI page.

RowWhat it opens or does
Model per taskA sheet to pin a provider and a model for each background task (autocomplete, analysis, SQL and design generation).
Visible modelsA sheet to tidy the model picker of the chat.
API KeysThe sheet where you add, check and remove provider keys. It opens only after the biometric check (see Biometrics).
Per-provider tuningTemperature, output limit and reasoning effort, one set per provider. It has no biometric check.
AI Tool PermissionsA sheet to restrict which tools each provider or model can call.
MCP ServersA sheet to connect external tool providers (Model Context Protocol). The servers you saved and switched on start with the app, not when you open the sheet; one still waiting for your confirmation stays off.
SecretsA sheet for tokens and API keys the assistant can use without seeing them.
Auto suggestionsA switch: show AI suggestions while you type. It needs Code completion.
AI titlesA switch: name conversations with the model. Off by default.
Code completionA switch: autocomplete code with AI.
Cortex: things at onceHow many agents Cortex may run at the same time: 1 to 4, default 2.
Contextual helpA switch: explain selected code. With it off, the quick explain action is not offered.
Zero-egress (no network AI)A switch: when on, the app makes no network AI calls and online models stay disabled until you turn it off.
SwarmcodeA sheet with the settings of the multi-agent mode with verification.
The step-by-step for keys, endpoints, models, MCP servers, tool permissions and secrets is on the AI page. Open the AI page

Integrations and runtimes

Two sections hand you off to other screens instead of holding settings of their own.

You can

  • Connected Services (“GitHub, Vercel, Supabase, Stripe and more”) opens the screen where you connect and manage third-party services, after a biometric check. Going back returns to Settings.
  • Additional language runtimes closes Settings and opens the Plugin manager. It starts with Languages, the real languages of the app's Linux, each with Install or Uninstall. Below are the optional runtimes: Rhai and Go through Yaegi can be installed, and Dart and SwiftWasm show Coming soon.

You can't, and why

  • Open Connected Services on a device with neither biometrics nor a screen lock: Settings refuses and shows “Set up a screen lock or biometric to access API keys.”Device
  • Install Dart or SwiftWasm: their entries are marked Coming soon and have no installable file.Not yet
  • Install a runtime from any other source: only files whose SHA-256 fingerprint is built into the app are installed.Google Play

Editor: writing and view

Two sections hold the editor's behavior. Theme, font, size and background are not here: they are in the Editor appearance sheet. The values in the tables are the defaults.

Editor · writing

SettingWhat it doesDefault
Tab size: 4 spacesChoose 2, 4 or 8 spaces for one indent level.4
AutosaveA single selector: Off, 1s, 2s, 5s or 10s. The save runs that long after your last keystroke; Off turns autosave off.2s
Auto indentIndents new lines automatically.On
Word wrapWraps long lines.Off
Code formatterShows the code formatting button.On

Editor · view

SettingWhat it doesDefault
Line numbersShows the numbering.On
Syntax highlightingColors code according to its language.On
MinimapShows a minimap of the code for quick navigation.Off
Find and replaceEnables the search bar; turning it off closes the bar.On
Status barShows line, column and file information.On
BreadcrumbShows the file path and the current symbol above the code.Off
Open in preview when navigatingGo to definition, search results, the AI and workflows reuse one italic tab until you edit it or keep it open.On
Invisible charactersShows spaces, tabs and line breaks.Off
Column guideShows a vertical ruler at a fixed column. A project's .editorconfig with max_line_length wins over the column you set.Off
Column guide: 80Choose the ruler's column: 80, 100 or 120.80
Font ligaturesJoins =>, != and -> in the fonts that support it: Fira Code, JetBrains Mono and Cascadia Code.Off
Line spacing: 1×Choose 1×, 1.15×, 1.3× or 1.5×.1×
Color swatchesShows a small sample next to colors such as #FF5722, rgb(…) or Color(0xFF…).On
Inlay hintsParameter names and inferred types from the language server, inside the code (TypeScript and JavaScript).Off

You can

  • Every switch applies as you flip it; there is no save button.
  • Use the search box at the top of Settings to find a row by a word of its name, such as “minimap” or “wrap”.

You can't, and why

  • Indent with real tab characters: the tab size selector is spaces only.By design

Project, behavior, maintenance and widgets

Five small groups: project backups, how the app behaves, the terminal, maintenance and the widgets of Home.

Project

SettingWhat it doesDefault
Create automatic backupEvery 30 minutes, when the battery is not low, the app zips each of your projects into its own private storage and keeps the last 5 zips of each project.On
File compressionCompresses those zips; with it off they are stored uncompressed (faster, larger).On

Behavior

SettingWhat it doesDefault
VibrationHaptic feedback on interactions.On
Reduce motionMinimizes animations. If Android's own animation scale is below 1× a note under the row shows it (for example “System scale: 0.5x”), and Disabled by system when animations are off in Android.Off
Confirm before deletingWhen on, deleting a file from its menu and Delete selection in the file explorer ask first; when off they delete at once, with no question.On

Terminal

SettingWhat it doesDefault
Terminal auto-reconnectReconnects SSH sessions automatically when the network returns. Theme and font of the terminal are in Terminal appearance.On

Maintenance

SettingWhat it doesDefault
Clear cacheDeletes the app's temporary files, with no confirmation, and shows Cache cleared successfully.—
Reset to defaultsAfter a confirmation, puts every setting of the app back to its default (editor, app, AI, project, session backup, sync, shortcuts and accessibility), switches Cloud Sync off and schedules the automatic backup again. It does not touch your API keys or your files, and it does not reset the terminal's size, font, opacity or picture, Zero-egress, your privacy choices, quiet hours or notification types.—

Advanced Tools: Dashboard Widgets

SettingWhat it doesDefault
Dashboard WidgetsCloses Settings, goes to Home and opens Configure widgets: switch each of the 21 widgets on or off (all are on except the installed-assets one), move them with Move up and Move down (there is no drag handle), make one Two columns wide on a tablet and choose your quick actions. The other four rows of Advanced Tools have their own sections below.—

You can't, and why

  • Open, browse or restore the automatic backup zips from the app: they sit in the app's private storage and no screen reads them.Not yet
  • Pick the time of the automatic backup or get a notice when it ends: it is a periodic Android job and the system decides when it runs.Device
  • Undo Reset to defaults: the dialog warns that it cannot be undone.By design

Notifications and quiet hours

The Notifications row shows a summary (On, Off or On · quiet hours 23:00 – 08:00) and opens its own screen, headed “Settings › Notifications”. Going back returns to Settings.

You can

  • Allow notifications is the master switch for everything PocketCode sends. It is on by default; switching it on asks Android for permission when that is needed.
  • Permission shows Allowed by Android, Blocked by Android — tap to open settings or Not asked yet — tap to allow; tapping it asks or opens Android's settings. PocketCode asks for the permission here, in context, not when the app starts.
  • Quiet hours opens a sheet (below).
  • By module lists Backend Manager (with a PRO badge) and four modules: AI Office, Workflows, Cortex and News and updates. Each module opens a page with one switch per notification type.
  • Android settings, at the foot of the screen and of each module page, opens the app's notification settings in Android. Sound and vibration are set there, per channel; PocketCode registers 19 channels. What you turn off in PocketCode is never sent later.

You can't, and why

  • Configure Backend Manager notifications on the Free plan: the row carries a PRO badge and opens the Pro screen. The rest of this screen is free.Pro
  • Receive notifications without Android's permission (Android 13 and later).Device
  • Choose sound or vibration for each type inside PocketCode: they belong to the Android channels.By design

Types you can switch on or off

Ten notification types in four modules. A module row says how many types are on, for example “1 of 2 types on”.

ModuleTypeWhen it fires
AI OfficePlan readyThe plan is ready to review, or it was re-planned.
AI OfficeSession completedEvery task of the session finished.
AI OfficeSession pausedThe session stopped and is waiting for you.
AI OfficeSession failedThe session stopped with an error.
AI OfficeTask failedOne task failed while the session goes on. It arrives quietly.
WorkflowsAlertsNotification steps you marked as high importance. They make sound.
WorkflowsQuiet noticesThe other workflow notifications. They arrive without sound.
CortexDecisions waitingA mission needs your decision to go on.
News and updatesUpdatesNew versions, weekly summaries and Marketplace updates.
News and updatesCommunityNews from the community and the Marketplace.

Quiet hours sheet

  • The switch is off by default. “Notifications still arrive, without sound or vibration.”
  • From and To open a time picker. The range starts as 23:00 to 08:00 and may cross midnight.
  • Let "Monitor down" through (off by default): a site going down still makes a sound during quiet hours.

Session backup

Session Backup keeps dated copies of your editor session so you can go back to how your tabs were. Open it from Advanced Tools › Session Backup; the dialog is titled Session Backup.

You can

  • Turn Auto Backup on or off (on by default). With it off the options below are disabled, but Backup Now still works.
  • Set Backup Interval: 5 min, 15 min (default), 30 min or 1 h.
  • Set Max backups with the minus and plus buttons: from 3 to 30, 10 by default. When there are more, the oldest copies are deleted.
  • Keep Backup on app close on (default) to take one more copy when the app goes to the background.
  • Press Backup Now to copy your last saved session at once. The dialog then shows Last backup.
  • Under Saved snapshots, each copy shows its date and time. Restore puts those tabs back in the editor, replacing the tabs you have now; the bin deletes that copy.

You can't, and why

  • Recover unsaved text or the undo history from a copy: a copy never contains the text of your files, and Include unsaved changes (on by default) has no effect today.Not yet
  • Keep fewer than 3 or more than 30 copies, or use an interval other than 5, 15, 30 or 60 minutes.By design

What a copy holds, and when one is taken

  • A copy records which files are open in the editor, which tabs are pinned, and where the cursor, the selection and the scroll were in each tab. It stores no file text and no undo history.
  • Automatic copies are made by the IDE page, at your interval and, with Backup on app close, whenever the app goes to the background. Backup Now works from the dialog at any time, but it copies the last saved session: if no session has been saved yet, nothing is added to the list.
  • The copies are files in the app's private storage. They are a different thing from the project zips of Create automatic backup.

Cloud Sync

Cloud Sync keeps part of your setup in step across the devices you sign in on. It is a Pro feature, off by default, and it never uploads the code of your projects, your .pcd designs or your database schemas. Open it from Advanced Tools › Settings & data sync; the dialog is titled Settings Sync.

The dialog has seven checkboxes, one per group: three under Core Settings, one under Data & Projects and three under Automation & AI. Connections (SSH/DB) works apart from the other six: it sends the details of your SSH hosts and the metadata of your database connections to PocketCode's server only while Enable Sync is on and its box is ticked. Details in the table and in Limitations.

You can

  • Turn on Enable Sync (“Sync settings across devices”). Switching it on needs Pro; switching it off is always possible.
  • Choose what travels with the seven checkboxes of What to sync, in three groups: Core Settings, Data & Projects and Automation & AI. Your shortcut scheme and your editor theme travel inside Settings; they have no boxes of their own.
  • Tick Connections (SSH/DB) to send the details of your SSH hosts (name, address, port, authentication method, tags and a few SSH options, never passwords, keys or the startup command) and the metadata of your database connections (name, host, port, engine and group label, never the user, the password, the TLS settings or the rest of the connection's data). They travel when you save or edit a connection or open a PlanetScale branch; deleting one removes its copy. A database connection with no host, such as a local file, is not sent. It works only while Enable Sync is on: with Cloud Sync off or the box cleared, nothing about your connections leaves the device.
  • Choose Conflict Resolution: Keep local changes, Use remote changes, Ask each time (default) or Merge automatically.
  • Press Sync Now to sync right away. The dialog shows the status (Idle, Syncing…, Synced or Sync error), Last sync and, after a run, a tick or a cross for each group under Sync Results.
  • Cloud Sync also runs by itself when you sign in and when the network comes back, as long as it is switched on.

You can't, and why

  • Switch Cloud Sync on with the Free plan: a Pro sheet opens instead. If Pro ends, Cloud Sync is switched off for you.Pro
  • Sync the code of your projects, your .pcd designs or your database schemas: those uploads were removed on purpose.By design
  • Make Ask each time ask or Merge automatically merge: both behave like “the newest wins”, and no question or merge screen exists.Not yet
  • See on another device the connections you synced: the app downloads the list from the server, but no screen reads it yet.Not yet
  • Sync while offline or signed out, or when PocketCode has paused Cloud Sync for everyone with its remote switch.Needs network

What each group syncs

For each group the app compares the last change on this device with the one in the cloud and copies the newer side to the other. The cloud copy is kept in your own account.

Group (as the dialog names it)What travelsWhat never travels
SettingsApp and editor settings: theme mode, language, autosave, Reduce motion, Vibration, navigation transition, Allow notifications, Confirm before deleting, editor theme, font and size, line numbers, word wrap, syntax highlighting, auto indent, tab size, formatter, minimap, find and replace, status bar, breadcrumb, preview tabs, invisible characters and the shortcut scheme. Your AI provider choice, Auto suggestions, Code completion and Create automatic backup are uploaded too, but not applied when you download.Your edited shortcut rows (only the scheme name travels), accessibility, session backup, column guide, ligatures, line spacing, color swatches, inlay hints and the terminal appearance.
SnippetsTerminal snippets and quick scripts. The whole list is replaced, item by item merging does not exist.—
Stats & StreakYour statistics and streak. Counters keep the higher of the two values, so no device lowers your totals.—
Connections (SSH/DB)The details of your SSH hosts: name, address, port, authentication method, tags and a few SSH options such as the username and the host's proxy. Also the metadata of your database connections: name, host, port, engine and group label. They travel when you save, edit or delete a connection or open a PlanetScale branch (Sync Now only downloads the list), and only while Enable Sync is on and this box is ticked.Passwords, keys, tokens and the startup command of a host; the user, password, TLS settings and the rest of a database connection's data.
WorkflowsWorkflow definitions. Deleting a workflow on one device deletes it on the others. If both devices changed the same workflow, the cloud version keeps its name and your change is kept as a separate, switched-off copy with “(conflicto)” added to the name.Run history, schedules and pinned data stay on the device. Secret header and parameter values are sent empty.
ExtensionsThe list of installed extensions and whether each is enabled.The extension files: the Marketplace downloads them again on the other device.
AI ConversationsConversations, including the text of their messages, and pinned state. Conversations that have not changed for about six months (180 days) are neither uploaded nor downloaded.—

Reading the dialog

  • Sync error appears when the run reports a failure or when it has not finished after one minute, for example because you are offline or signed out. Check the per-group ticks under Sync Results.
  • The checkboxes are disabled while Enable Sync is off, and Sync Now is disabled while it is off or a sync is running.

Separate from Cloud Sync: theme, language and notifications

A lighter mechanism runs on every plan and does not depend on Enable Sync.

  • A couple of seconds after you change any setting, when you sign in and when the network returns, PocketCode sends your theme mode, your language and the Allow notifications switch to your PocketCode account, and it reads them back when the app starts.
  • Nothing else is sent by this mechanism. It is why a fresh install on a new phone starts with your theme and language.

Keyboard shortcuts

Open Advanced Tools › Keybindings. The dialog has a Keymap row of scheme chips, a search box (Search keybindings…), category chips and the list of shortcuts, with Reset to Defaults at the foot. The shortcuts are for a hardware keyboard (Bluetooth, USB or Samsung DeX). There are 26 actions and five schemes.

You can

  • Choose a Keymap: PocketCode (default), VS Code, IntelliJ IDEA, Sublime Text or Atom. Choosing one rewrites the whole table below it. A sixth chip, Custom, appears only after you edit a row and cannot be picked.
  • Search by action name or by combination, and filter by category: All, Editor, Navigation, File, Search, Terminal, Debug and General. Terminal is empty: its rows were retired.
  • Press Reset to Defaults to apply the PocketCode keymap again.
  • Read the warning on two rows that share a combination: Same shortcut as … In that case the app does not guess: it runs neither action until you change one.

You can't, and why

  • Record a shortcut by pressing the keys: you type the combination as text.By design
  • Add new actions, or use chords such as Ctrl+K Ctrl+B: a combination is one key plus modifiers, so the schemes keep PocketCode's key for actions that other editors bind to a chord.By design
  • Rebind cut, copy, paste, select all, indent, outdent, toggle terminal, new terminal and toggle sidebar: those nine rows were retired because the editor handles them with fixed keys or nothing listened to them.By design
  • Use these shortcuts without a physical keyboard.Device

Editing a shortcut

  • Tap a row, type the combination (for example Ctrl+Shift+P) and confirm with the check mark. The keymap chip becomes Custom.
  • Modifiers are Ctrl (also Cmd or Meta), Shift and Alt (also Option). The key is a letter, a digit, F1 to F12, an arrow (Up, Down, Left, Right), Enter, Escape, Tab, Space, Backspace, Delete, Home, End, PageUp, PageDown or a punctuation key such as /, [, ], ,, ., ;, - or =. Exactly one key is allowed.
  • A combination that cannot be read is ignored: that action simply has no shortcut, and it does not count as a duplicate.
  • Modifiers are compared exactly: Ctrl+S does not fire on Ctrl+Shift+S.

The 26 default shortcuts

Names and categories are shown in English in every language. The editor follows the table for 18 of the actions; the command palette and Quick Open follow it too, and so does the workflow editor.

ActionDefaultWhere it works
Save File (save)Ctrl+SEditor, workflow editor
Save All (save_all)Ctrl+Alt+SEditor
Undo (undo)Ctrl+ZEditor, workflow editor
Redo (redo)Ctrl+Shift+ZEditor, workflow editor
Find (find)Ctrl+FEditor
Find & Replace (replace)Ctrl+HEditor
Find in Files (find_in_files)Ctrl+Shift+FEditor
Command Palette (command_palette)Ctrl+Shift+PAny screen
Quick Open File (quick_open)Ctrl+PEditor (file search); elsewhere it opens the palette
Go to Line (goto_line)Ctrl+GEditor
Close Tab (close_tab)Ctrl+WEditor
Next Tab (next_tab)Ctrl+TabEditor
Toggle Comment (comment_line)Ctrl+/Editor
Duplicate Line (duplicate_line)Ctrl+Shift+DEditor
Move Line Up (move_line_up)Alt+UpEditor
Move Line Down (move_line_down)Alt+DownEditor
Toggle Breakpoint (toggle_breakpoint)F9Editor
Start Debugging (start_debug)Shift+F5Editor; during a debug session it continues instead
Step Over (while debugging) (step_over)F10Editor, only during a debug session
Step Into (while debugging) (step_into)F11Editor, only during a debug session
Duplicate Step (Workflows) (workflow_step_duplicate)Ctrl+DWorkflow editor
Delete Step (Workflows) (workflow_step_delete)DeleteWorkflow editor
Move Step Up (Workflows) (workflow_step_move_up)Ctrl+UpWorkflow editor
Move Step Down (Workflows) (workflow_step_move_down)Ctrl+DownWorkflow editor
Test Workflow (workflow_test)Ctrl+EnterWorkflow editor
Back (Escape) (escape_back)EscapeWhole app, with Escape to Go Back on

The editor's own fixed shortcuts keep working as long as the table does not give their key to another action.

What each scheme changes

Only the rows that differ from PocketCode are listed; every other shortcut is the same in all five schemes: VS Code changes 3, IntelliJ IDEA 13, Sublime Text 3 and Atom 5.

VS Code

ActionPocketCodeVS Code
Redo (redo)Ctrl+Shift+ZCtrl+Y
Duplicate Line (duplicate_line)Ctrl+Shift+DShift+Alt+Down
Start Debugging (start_debug)Shift+F5F5

IntelliJ IDEA

ActionPocketCodeIntelliJ IDEA
Find & Replace (replace)Ctrl+HCtrl+R
Command Palette (command_palette)Ctrl+Shift+PCtrl+Shift+A
Quick Open File (quick_open)Ctrl+PCtrl+Shift+N
Close Tab (close_tab)Ctrl+WCtrl+F4
Next Tab (next_tab)Ctrl+TabAlt+Right
Duplicate Line (duplicate_line)Ctrl+Shift+DCtrl+D
Move Line Up (move_line_up)Alt+UpShift+Alt+Up
Move Line Down (move_line_down)Alt+DownShift+Alt+Down
Toggle Breakpoint (toggle_breakpoint)F9Ctrl+F8
Start Debugging (start_debug)Shift+F5Shift+F9
Step Over (step_over)F10F8
Step Into (step_into)F11F7
Duplicate Step (workflow_step_duplicate)Ctrl+DCtrl+Shift+D

Sublime Text

ActionPocketCodeSublime Text
Redo (redo)Ctrl+Shift+ZCtrl+Y
Move Line Up (move_line_up)Alt+UpCtrl+Shift+Up
Move Line Down (move_line_down)Alt+DownCtrl+Shift+Down

Atom

ActionPocketCodeAtom
Redo (redo)Ctrl+Shift+ZCtrl+Y
Move Line Up (move_line_up)Alt+UpCtrl+Up
Move Line Down (move_line_down)Alt+DownCtrl+Down
Move Step Up (workflow_step_move_up)Ctrl+UpCtrl+Alt+Up
Move Step Down (workflow_step_move_down)Ctrl+DownCtrl+Alt+Down

step_over and step_into act only during a debug session, whatever the scheme (with IntelliJ IDEA, F8 is still “next problem” outside one). Only your keymap name travels with Cloud Sync, not your edited rows.

Accessibility

Open Advanced Tools › Accessibility (“Keyboard navigation & screen reader”). The dialog has three switches and one color choice, aimed at hardware keyboards.

You can

  • Show Focus Indicators (on by default): draws a visible border around the app's standard buttons when you reach them with the keyboard.
  • High Contrast Focus (off): makes that outline thicker, 3 dp instead of 2 dp.
  • Focus outline color: choose one of six colors, blue #2196F3 by default, green, orange, purple, red or cyan. It shows only while focus indicators are on.
  • Escape to Go Back (on): with a physical keyboard, Escape goes back one step in the app's navigation. It is the escape_back row of the shortcuts.

You can't, and why

  • Switch on keyboard navigation, set the Tab order or arrow-key navigation, or use a screen-reader mode: these four options exist in the saved data but have no controls and nothing reads them, so the row's description promises more than the dialog offers.Not yet
  • Get a focus outline on every control: only the app's standard buttons draw one today.Not yet
  • Pick any color for the outline: six presets only.By design

Privacy and data

The Privacy section has three switches, a plain list of what the app handles and the account deletion row. Allow analytics and Crash reports are off until you accept, and the app keeps Firebase collection disabled until then. Anonymous statistics is on by default and carries no account and no identifier.

You can

  • Allow analytics (off until you accept): which screens and features you use, linked to a random ID of this installation, through Firebase Analytics.
  • Crash reports (off until you accept): error reports through Firebase Crashlytics. After a crash the app asks whether to send that report: Send, Always send or Don't send. Always send turns Crash reports on.
  • Anonymous statistics (on by default): counts which screens are used and how long the app takes to open, with no account and no identifier. Turning it off deletes what had been accumulated.
  • Tap What data we collect (“Usage analytics, crash reports and anonymous statistics. Never your code.”) to open Data We Collect: five categories, Usage Analytics (Firebase Analytics), Crash Reports (Firebase Crashlytics), Anonymous statistics (on by default), Authentication (Firebase Auth) and Subscriptions (RevenueCat). It closes with a note that your code, projects and API keys are not sent to our servers unless you choose to: Cloud Sync uploads what you sync and a bug report includes what you write in it.
  • The first time you open the app, the Privacy & Data Collection dialog offers Usage Analytics and Crash Reports, both off. Reject All and Accept All sit side by side at the same level, and Save Choices keeps what you chose. Everything can be changed later in this section, and Anonymous statistics, which is on by default, is switched off here too.
  • Tap Delete my account and data (next section).

You can't, and why

—

What leaves your device, and when

WhatWhen
Usage events, linked to a random ID of this installation and not to your account: features used, navigation, project creation and file operations, and AI model usage by provider and latency.Only if Allow analytics is on. Each settings change is also counted: the setting's name and its new value; paths and free text are replaced by redacted.
Crash reports: stack traces, device model, Android version, app version and build number, your last steps in the app (screens and actions from a fixed list) and a random ID of this installation.If Crash reports is on, or when you choose Send for a report after a crash. Always send turns the switch on.
Anonymous statistics: screens opened and Pro features reached, per day; how long the app takes to start; app and Android version; phone or tablet. No account, no identifier, no text.On by default. Turn it off with Anonymous statistics and what had been accumulated is deleted.
Your account (email, optional username, sign-in provider) and your subscription state.While you are signed in, through Firebase Auth and RevenueCat. No payment card data is stored.
Theme mode, language and the notifications switch.On every plan, a few seconds after you change a setting, at sign-in and when the network returns. See Cloud Sync.
The Cloud Sync groups you left on, which can include AI conversation text, the raw bodies and scripts of API requests and, with Connections (SSH/DB), the details of your SSH hosts and the metadata of your database connections (never passwords, keys or database credentials).Only on Pro, with Enable Sync on.
A bug report: your text plus masked diagnostics.Only when you press Send.
Your project code, and your API keys.Never sent to PocketCode. AI requests go from your device straight to the provider you chose.

Where things are stored

  • Your settings are stored in the app's private storage, one set per account.
  • API keys are stored separately, encrypted with a key held in the Android Keystore (see the AI page).
  • Telemetry is built to carry no user content: file names, paths, SSH hosts, project names and error texts are replaced by a short hash, an extension, a category or redacted before they are sent.

Biometrics: what it protects

PocketCode asks for your fingerprint, face or screen lock before it opens a few sensitive things from Settings. The prompt is titled Verify identity. On Android 11 and later it also accepts your PIN, pattern or password; on Android 9 and 10 it accepts only a strong biometric.

What it protectsHow it asksWithout biometrics or a screen lock
API Keys“Authenticate to access your API keys”.With no screen lock at all, the sheet opens without asking, so you can add your first key. With a screen lock but no usable prompt, it does not open and you see “Set up a screen lock or biometric to access API keys.”
Connected Services“Authenticate to access connected services”.Always refuses and shows the same message.
Delete my account and data“Authenticate to delete your account and data”, after you type the confirmation word.The prompt is skipped when it cannot be shown: the typed word is the second step.
The chat's Edit API key actionNo prompt: it opens the keys sheet directly.—
Per-provider tuning, AI Tool Permissions, MCP Servers and SecretsNo prompt.—
The check is a door in the app, not a key: the stored API keys are encrypted with a Keystore key that does not need your fingerprint, so background tasks can use them. Biometrics in other modules (database, Backend Manager, SSH) belong to their own pages.

You can't, and why

  • Open API Keys on Android 9 or 10 with a PIN but no enrolled fingerprint: the sheet refuses even though the phone is protected, because only a strong biometric is accepted there.Device

Delete my account and data

Privacy › Delete my account and data (“Permanently delete your PocketCode account and all your cloud data (GDPR)”) is the red row. It deletes the account and its cloud data on PocketCode's server: friendships and friend requests, messages, the GitHub token stored for you, the subscription record, the two-factor secret and its recovery codes, push-notification tokens, saved connections and bug reports. It does not delete what is stored on this device.

  1. 1Read the dialog: it says the deletion removes your PocketCode account and everything stored for it in the cloud (profile, subscription record, synced settings, and usage and analytics data), that it cannot be undone, and that files and projects stored on this device are kept.
  2. 2Type the confirmation word in the field, Type DELETE to confirm (capitals do not matter). The red Delete account button stays disabled until it matches.
  3. 3If the phone can show the biometric prompt (a fingerprint or face, and on Android 11 and later also your PIN, pattern or password), you confirm with it (Verify identity).
  4. 4PocketCode asks the server to delete the account. On success you see Your PocketCode account and cloud data were deleted, the app signs you out of this device and restarts at the sign-in screen.
The profile screen has its own Delete my account button under Danger zone. It now asks the server to delete the same data, so both paths clear the cloud side. They still differ on the device: the profile path first re-authenticates you (your password, or signing in again with the linked account), then wipes this account's data on the phone (projects, databases and settings) and restarts the app, while this row asks for the typed word and your fingerprint or screen lock and keeps your files and projects. The profile flow is explained on the Account page. Account, profile & security

You can't, and why

  • Delete only the data on this device with this row, or undo the deletion.By design
  • Delete the account without a connection: if the request fails you see the server's message or Failed to process data deletion request, nothing is deleted and you stay signed in.Needs network

About, bug reports and licenses

The last section starts with Report a bug (“Send a bug report to the team”), followed by an info card and a list of links.

You can

  • Read PocketCode IDE with its Version (the version name with the build number in brackets), Team (PocketCode Team) and Contact ([email protected]).
  • Rate PocketCode opens the Google Play listing. Share PocketCode opens Android's share sheet with a ready message and the Play link. Send feedback opens the report sheet with Suggestion already selected.
  • Open source licenses opens the list of components (below). Privacy policy (pocketcodeapp.com/privacy), Terms of service (pocketcodeapp.com/terms) and Terms & Conditions (pocketcodeapp.com/legal) open in your browser.

You can't, and why

—

Report a bug sheet

A sheet titled Report a bug (“Goes straight to the developer”). It opens from the first row of About, from Send feedback and, on the beta channel, from the bug button of the navigation bar.

You can

  • Pick the type with the chips Bug, Suggestion or Other.
  • Write under What happened? (“Tell us what you did and what you expected.”): between 10 and 4,000 characters. With fewer than 10 the field says Add a bit more detail — at least 10 characters.
  • Press Send. The report goes to PocketCode with masked diagnostics: the screen, app version, plan and channel, device maker and model, Android version, language, memory and filtered logs. It never carries your IP, email, Android ID, push token, project names or paths, chat text or file contents.
  • If it cannot be sent at all you see We couldn't send your report. and Send by email instead, which prepares an email to [email protected].

You can't, and why

  • Send a report at once without a connection: it is saved (“Saved — it will be sent when you're online”) and a background job retries it.Needs network

Open source licenses

A full-screen list of the third-party components PocketCode is built on. The summary at the top counts the components and the licenses of your version; the current bundle lists 825 components under 32 licenses.

You can

  • Search with Search components…, filter with the license chips (All first) and tap a component to read its full license text.
  • Read Required legal notices: the Consolidated NOTICE; BusyBox source (GPL-2.0), whose Save source to Downloads button saves the four GPL files to Download/PocketCode-GPL with no connection; LGPL relink right for Sora Editor and TinyCC; and Language servers (downloaded on request).
  • Most entries (728 of 825) are language servers and packages that are only downloaded if you install them. They are marked Downloaded on request and are not part of the app file.

You can't, and why

—

Free and Pro

Almost everything in Settings is included on Free. These are the Pro parts, with the exact counts.

SettingFreePro
Editor themes (Editor appearance)Same as app, PocketCode Dark, PocketCode Light, VS Code Dark+ and GitHub Light.Those plus 19 more: Monokai, Dracula, Solarized Dark, Nord, One Dark, Night Owl, GitHub Dark, Catppuccin Mocha, Ayu Mirage, Solarized Light, Gruvbox Dark, Gruvbox Light, Tokyo Night, Material Palenight, Synthwave '84, Cobalt2, Horizon, Panda Syntax and Rosé Pine. Themes from the Marketplace, theme import and Theme Studio in the editor also need Pro.
Terminal themes (Terminal appearance)Same as app, PocketCode Dark, PocketCode Light, Dark and Light.Seven more: Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark and Nord.
Fonts of the editor and of the terminalDefault (the system monospace font).Seven more: JetBrains Mono, Fira Code, Source Code Pro, Cascadia Code, Roboto Mono, Ubuntu Mono and Inconsolata.
Cloud Sync (Enable Sync)Cannot be switched on.Seven groups: settings, snippets, stats, connections (SSH hosts and database connections), workflows, extensions and AI conversations.
Backend Manager notificationsThe row carries a PRO badge and opens the Pro screen.Choose which backend events notify you.
Provider keys, models, MCP servers and the AI switchesIncluded. Adding your own keys is free.Included.
Everything else in SettingsIncluded: notifications, quiet hours, session backup, shortcuts, accessibility, privacy, support and licenses.Included.

The Pro sheets

  • Choosing a Pro theme opens a sheet titled 19 Pro Themes with Unlock Pro Themes and Not now. The number matches the 19 Pro themes of the editor (the terminal has 7 more Pro themes).
  • Choosing a Pro font opens 7 Pro Fonts with Unlock Pro Fonts. There are 7 Pro fonts (8 options with Default).
  • Switching on Enable Sync opens a generic sheet with Unlock with Pro. Its title and description come from the feature's own text, which the app writes in Spanish in every language.
  • All three lead to the Pro screen. Pro cards carry a lock in the theme carousel and a PRO badge next to each font while you are on Free.

When Pro ends

When a subscription expires, three Pro settings are reset for you. Nothing is deleted.

SettingIs reset toNotes
Editor themeSame as appUnless it was Same as app, VS Code Dark+ or GitHub Light: PocketCode Dark and PocketCode Light, although free, are reset too.
Editor fontDefaultOnly if it was a Pro font.
Cloud SyncSwitched offYour data stays in the cloud and on your devices.
Not reset—The terminal theme and font, your AI provider and keys, projects, designs, connections, stats and conversations.
For prices, periods and the full Free and Pro matrix, see the Plans page. Plans & Pricing

Limitations

What Settings cannot do today, and why. Items marked “Not yet” are visible in the app but do nothing, or do less than their text says.

  • Include unsaved changes has no effect: session copies never hold file text or undo history.Not yet
  • Ask each time and Merge automatically behave like “the newest wins”.Not yet
  • Connections (SSH/DB) only sends: no screen shows on another device the connections you synced.Not yet
  • Four accessibility options (keyboard navigation, Tab order, arrow keys, screen reader) have no controls and no effect.Not yet
  • The automatic project backups cannot be browsed or restored from the app.Not yet
  • Dart and SwiftWasm cannot be installed yet, and runtimes install only from fingerprints built into the app.Not yet
  • Pro themes, Pro fonts, Enable Sync and Backend Manager notifications need Pro.Pro
  • The editor font size has four steps (12, 14, 16, 18sp), the terminal's 9 to 20sp, and the focus outline six colors.By design
  • Shortcuts cannot be recorded, chorded or added, and nine old actions were retired.By design
  • Settings has no link from outside the app and cannot be screenshotted.By design
  • Connected Services needs biometrics or a screen lock; API Keys refuses a PIN-only phone on Android 9 and 10; shortcuts need a hardware keyboard.Device
  • Notifications need Android's permission on Android 13 and later.Device
  • Cloud Sync and account deletion need a connection and a signed-in account.Needs network

Troubleshooting

The messages below are the ones the app shows, in English.

Set up a screen lock or biometric to access API keys.

Shown when you tap API Keys on a phone that has a screen lock but cannot show the prompt, or Connected Services on a phone with no lock and no biometrics. Set up a screen lock or a fingerprint in Android's settings. On Android 9 and 10 a PIN alone is not accepted for API Keys: enroll a fingerprint or face the device certifies as strong, or update to Android 11 or later.

Biometric authentication is unavailable on this device.

Shown when Settings has no window to attach the prompt to. Close Settings and open it again.

Could not change language

The language switch failed. Try again, or pick System Default.

Could not restore default settings

Reset to defaults could not save. Try again.

Couldn't load that image

The picture you chose for Background image could not be read or copied into the app. Choose another image.

Blocked by Android — tap to open settings

The notification permission was denied. Tap the Permission row to open Android's settings and allow notifications for PocketCode.

Nothing matches “…”

No setting contains all the words you typed. Try fewer words or another word of the setting's name.

Same shortcut as …. While it is duplicated, the app does not guess which action to run.

Two rows of Keybindings have the same combination. Change one of them; until then neither runs.

Sync error

Shown in Settings Sync when a run fails or does not finish within a minute: you may be offline or signed out, or PocketCode may have paused Cloud Sync. Press Sync Now again and check the ticks under Sync Results.

Failed to process data deletion request

The request to delete the account did not go through, and nothing was deleted. If the server sends its own message you see that instead. Check your connection and try again.

Add a bit more detail — at least 10 characters.

The text of the report is shorter than 10 characters.

We couldn't send your report.

Tap Send by email instead to write to [email protected].

No email app found.

The email fallback needs an email app on the phone. Install or set one up, or write to [email protected] yourself.

Could not load the license bundle.

The list of licenses could not be read. Close the screen and open it again.

Could not save BusyBox source. Check storage permissions.

The Save source to Downloads button could not write to Download/PocketCode-GPL. Check the storage permission and the free space.