Linux Terminal
PocketCode's terminal gives you a real shell on your phone, with your projects as the home folder, tabs, a split view and a panel of 20 tools. It starts as BusyBox ash on a native pseudo-terminal; set up the app's optional Linux and it opens Alpine, with apk to install what you need. Remote work (SSH hosts, SFTP, port forwarding) has its own page.

What it is and how to open it
The Terminal is not one of the five pages of the pager: it opens over the app as a full-screen overlay. There are three ways in.
- 1Tap the Tools button in the navigation bar and choose Terminal in the Dev tools sheet.
- 2Open the command palette and run Open Terminal ("Open a terminal session").
- 3On Home, tap the Terminal quick action. It is one of the three quick actions shown by default.
Screen map
The Terminal is three screens (start, Terminal, SSH) that share one tab bar, one tools panel and one set of tool sheets. This page covers the start screen, the local Terminal screen and every tool the local shell has; the SSH screen is on its own page.
| Screen | How you get there | What you can do |
|---|---|---|
| Start screen | Opens first. Back from a session returns here. | Pick Local Shell, Quick Connect or Browse Hosts. Resume a running session from the chips above. |
| Terminal (local shell) | Local Shell on the start screen, or a local session chip. | Tabs, split view, search in output, the input bar, gestures and all the tools below. |
| SSH screen | Quick Connect or Browse Hosts on the start screen. | Remote tabs with their own set of 32 tools. Covered on the SSH page. |
| Docked tools panel | Automatic on a wide screen (660 dp or more, no split view). | A strip of tool icons with the open tool below it. 20 tools on the local shell. |
| Tools menu | The wrench button (More options) in the tab bar, when no panel is docked. | Six categories on the local shell, Search action…, a FREQUENT row. Opens any tool as a full-screen sheet. |
| Snippets | Panel tool; menu → Snippets. | 98 built-in commands, your own, folders, Generate with AI. |
| Command History | Panel tool; menu → Session. | Search, star, re-run and delete the commands you sent from this tab. |
| File Manager | Panel tool; menu → Linux Tools. | Browse folders, create a folder or file, print a file, delete (after a confirmation). |
| Git Panel | Panel tool; menu → Linux Tools. | Status, branches, log and actions on a repository, through JGit. |
| Processes | Panel tool; menu → Linux Tools. | List, filter, sort and kill processes. |
| System Info | Panel tool; menu → Linux Tools. | OS, kernel, uptime, user and the phone's model and Android version. |
| Disk Usage | Panel tool; menu → Linux Tools. | One card per partition with a usage bar. |
| Network | Panel tool; menu → Linux Tools. | Run ping, nslookup, traceroute, curl, wget or dig against a target. |
| Environment Variables | Panel tool; menu → Linux Tools. | List, search, add, edit and unset variables. |
| Alias Manager | Panel tool; menu → Session. | List, create, run and remove aliases. |
| Background Jobs | Panel tool; menu → Session. | List jobs, kill one, bring one to the foreground. |
| Quick Scripts (Pro) | Panel tool; menu → Automation. | Save multi-line scripts and run them line by line. |
| Keyboard Macros (Pro) | Panel tool; menu → Automation. | Save key sequences and send them to the session. |
| Expect Rules (Pro) | Panel tool; menu → Automation. | Answer a prompt automatically when a pattern shows up in the output. |
| Recording | Panel tool; menu → Session → Start Recording. | Record the tab as an asciinema .cast file. |
| Session Logs | Panel tool; menu → Settings. | Log a session to an encrypted file, bookmark, comment and share it. |
| Share your dev server | Panel tool; menu → Session. | Give the dev server running on your phone a temporary public link. |
| Profiles | Panel tool; menu → Security. | Create and launch terminal profiles (see the limits). |
| Sync & Teams and Import / Export | Panel tools; menu → Settings. | Also in the local panel. Described on the SSH page. |
| Explain with AI | Sparkle button in the input bar, only after output that looks like a failure. | Get a plain-language explanation of the last 40 lines. |
| Copy to clipboard? | Appears by itself when a program asks for your clipboard (OSC 52). | Copy, Ignore or allow it for the rest of the session. |
| Command reads credentials and sends data out | Appears before such a command typed in the input bar runs. | Read what it touches, then Run anyway or cancel. |
The start screen
The start screen is the home of the module. It shows the title Terminal and the line "Local shell, remote SSH, and Linux tools in one place".
Local Shell
Opens a shell on this phone in the Terminal screen. A status line under the name says Busybox tools ready when BusyBox is linked, or Basic shell when only Android's own shell is available.
Quick Connect and Browse Hosts
Open the SSH screen with the Quick Connect or the Hosts sheet. Covered on the SSH page.
Open sessions
Chips above the cards list the sessions that are still running, so you can jump back into one.
On a narrow screen the cards stack in a column; on a wide one the title sits on the left and the cards on the right. Back from here leaves the Terminal.
You can
- Start a local shell with one tap on Local Shell.
- Resume any running session, local or remote, from the chips.
- Jump to the SSH screen with Quick Connect or Browse Hosts.
You can't, and why
- Trust the BusyBox status on a fresh install: it is read once when the screen draws, and BusyBox is linked the first time you open a shell, so the card can say Basic shell until you reopen the Terminal.Not yet
The local shell
The local shell is a real process on your phone, not an emulation of one.
- The app's Linux. An optional Alpine Linux for 64-bit ARM phones. Set it up from the Full Linux tool. From then on Local Shell opens Alpine and says Full Linux tools, with
apk addfor packages and your projects at~/projects. Your projects and your home folder stay when you repair or remove it; what you installed withapkgoes. - A command that's missing. When the shell answers
sh: php: not foundfor a known tool, a bar above the input tells you what to do: Install (~11 MB) in Alpine, Open Linux in the basic shell, or Set up Linux if it isn't installed yet. - Shell.
ashfrom BusyBox v1.34.1, shipped inside the app and started on a native pseudo-terminal (TERM=xterm-256color, resized with the screen). If BusyBox isn't available it falls back to Android's ownsh. - Applets. The BusyBox binary exports 373 applets. The first time you open a shell PocketCode links all of them, among them
awk,vi,sed,find,tar,gzip,unzip,wget,nc,ping,nslookup,traceroute,ifconfig,ip,netstat,topandless. If that step fails it links a core list of 70. The links are repaired the next time you open a shell after an app update. - Node.
nodeis linked into the shell when the build carries it for your device's architecture (arm64-v8a and x86_64), withNODE_OPTIONS=--no-addons. npm is not included. - Home.
~is your projects folder.ls,grepanddiffare colored aliases andllisls -la(PocketCode checks the shell's.ashrcon every start and restores it if it differs). - Database. While the local PostgreSQL engine is running,
DATABASE_URLand thePG*variables are set in the local shell only, never on SSH sessions. - Output. The output is a list of lines (the last 10,000 per tab). Colors and styles are drawn (16, 256 and RGB colors, bold, dim, italic, underline), carriage returns collapse progress bars, and backspace and tab stops work. Cursor movement, screen clearing, mouse tracking and other control sequences are dropped.


What isn't here, and why
- A package manager in the basic shell: there is no
apt,dpkgorpkg. For packages, set up the app's Linux and useapk.Google Play git. Use the Git Panel (it talks to JGit) or Source Control in the editor.By designpython,docker,curl,ssh,scp,zipandnanoin the basic shell: they are not in the BusyBox build. Most install withapkin the app's Linux; Docker isn't available there. For another machine, use the SSH screen.Google Play- Root,
chroot/prootor a Linux distribution: the shell has the app's own user and nothing more.Device - Programs that redraw the whole screen, such as
vi,toporless: they don't draw as a screen because cursor movement is dropped.top -n 1is offered as a chip in Processes.By design
Sessions, tabs and gestures
Each tab is one session. The tab bar is shared by the local and the SSH screens, but each screen shows only its own kind of tab.
Tabs, split view and search
- + opens another local shell on this screen (on the SSH screen it opens the Hosts sheet).
- Long-press a tab for Rename and Close other tabs (a remote tab also offers Duplicate session). Closing a local tab is immediate; closing the other tabs asks first.
- Each tab has a status dot (a local tab is always green), and an extra dot appears on a tab that got new output while you were elsewhere. The chips LOG and REC show up in the bar while logging or recording is on.
- The split button cycles Split Horizontal, Split Vertical, No Split. The second pane shows the next tab, the active pane has an accent border and a tap on a pane focuses it. Split view is Pro.
- The magnifier (Search Output) opens Search in output… with a count ("N of M") and previous and next buttons. It matches text anywhere in the line, ignoring case, and each split pane is searched on its own.
- Broadcast (send what you type to every connected tab) and Multiplexed Shell belong to remote tabs. They are covered on the SSH page.
Gestures and keys
| Double-tap the output | Sends Ctrl+C to stop the running command. |
| Swipe on the output | Sends arrow keys: left and right move the cursor, up and down browse the shell history. |
| Pinch the output | Changes the text size, from 8 to 24. The size is remembered. |
| Long-press the output | A menu with Copy line, Copy Output and Clear Terminal. |
| Tap a link | A web address opens in the browser. |
| Volume buttons | Act as the up and down arrows while Volume Keys ON is set. It is off by default and the switch lives in the tools menu, under Settings. |
The input bar
- A one-line field with Send. Everything you send from here is added to this tab's command history.
- Up to five suggestions appear as you type: known commands, commands from this tab's history, and paths that start with
/or~(local shell only, one level deep). - Previous command steps back through this tab's history.
- Attach file picks a file. On the local shell it is copied into your projects folder, with
(1),(2)added when the name is taken, and its path is inserted in the field. On a remote tab it is uploaded to/tmp. - Explain with AI appears when the latest output looks like a failure (see below).
Limits of the session screen
- A row of extra keys (ESC, TAB, Ctrl, F1 to F12). The only keys you can send are Ctrl+C (double-tap), the arrows (swipe) and whatever a macro sends.Not yet
- Open a file from the output: file paths and
file:line:columnreferences are highlighted but don't react to a tap. Only web addresses open.Not yet - A second session on the same screen in Free, and split view.Pro
Prompts a session can raise
Copy to clipboard? (OSC 52)
Appears by itself when a program in the session asks to put text on your clipboard.
A command, a script or a remote server can ask the terminal to copy text. PocketCode asks you first, because text pasted into a terminal can run commands.
You can
- Read "The session wants to copy N characters to your clipboard" with a preview of the text.
- Tap Copy or Ignore.
- Tick Allow for the rest of this session. That choice is kept in memory and forgotten when the session ends.
You can't, and why
- Let a session write to your clipboard without asking.By design
Command reads credentials and sends data out
Appears when a command you send from the input bar touches a credentials store and also sends data somewhere.
The dialog says what the command touches and where it goes. It is a warning, not a wall: it is there for commands copied from a tutorial or suggested by an AI, whose second effect is easy to miss.
You can
- Read the two things the command does.
- Tap Run anyway to send it, or cancel.
You can't, and why
- Have it block the command, or catch anything that doesn't go through the input bar.By design
The tools panel
Most of what you do besides typing commands happens in the tools. They appear in one of two ways, depending on the screen.
The 20 tools of the local shell, in panel order
Snippets, Command History, File Manager, Git Panel, Processes, System Info, Disk Usage, Network, Environment Variables, Alias Manager, Background Jobs, Quick Scripts, Keyboard Macros, Expect Rules, Recording, Session Logs, Share your dev server, Profiles, Sync & Teams and Import / Export. A remote tab adds 12 more, 32 in all (see the SSH page).
Docked panel
On a wide screen (660 dp or more) and with no split view, a 380 dp panel docks on the right: a strip of icons with the selected tool below it. There is always one tool selected (Snippets the first time) and the panel remembers the last one. The chevron in the tab bar (Collapse panel) folds it away.
Tools menu
On a phone, or when split view is on, the wrench button (More options) opens a menu with a search field (Search action…), a FREQUENT row (an action appears there after two uses, six at most) and these categories:
| Category | Actions on the local shell |
|---|---|
| Session | Share your dev server, split layout, Command History, Alias Manager, Background Jobs, Copy Output, Clear Terminal, Start Recording |
| Linux Tools | File Manager, Processes, Network, Disk Usage, System Info, Environment Variables, Git Panel |
| Snippets | All Snippets and eight category shortcuts (System, Docker, Git, Database, Security, Monitoring, Networking, Files & Text) |
| Automation | Keyboard Macros, Quick Scripts, Expect Rules |
| Security | Profiles |
| Settings | Session Logs, Sync & Teams, Import / Export, Volume Keys ON / Volume Keys OFF |
On an SSH tab there is a seventh category, Connection, and more actions in the others. Copy Output and Clear Terminal are also in the long-press menu of the output.

- Reach Volume Keys ON/OFF on a wide tablet with the panel docked: the tools menu isn't drawn there. (Starting a split view brings the wrench back.)Device
Linux tools
These tools are shortcuts for things you would otherwise type. The lists they show are read by a separate, non-interactive shell (each read is capped at 15 seconds and 512 KB). What you change from them (create, delete, kill, export) is typed into your session as an ordinary command, so you also see it in the output.
File Manager
Panel tool File Manager; menu → Linux Tools.
A folder browser built on ls -la.
You can
- Open folders and go up one level with Parent.
- Create a folder (New folder,
mkdir -p) or an empty file (New file,touch). - Tap a file to print it in the session with
cat. - Delete an entry with its trash icon. A Delete dialog titled Delete <name>? asks first: the file, or the folder and everything inside it, is removed for good, with no trash and no undo. Delete confirms; Cancel keeps it.
- The
rm -rftyped into the session has the path in quotes and special characters escaped, so a file named$(…)is deleted by name and never run. - Use the Quick Commands chips:
du -sh *,find . -name '*.log'andchmod +x.
You can't, and why
- Browse outside your projects folder: the browser stops there, and the folders that hold app credentials never open.By design
- Undo a delete, or send it to a trash.By design
- See owner, size or dates beyond what
ls -laprints.Not yet
Git Panel
Panel tool Git Panel; menu → Linux Tools.
A small Git panel with four tabs: Status, Branches, Log and Actions. On the local shell it uses JGit (there is no git program); on an SSH tab it types git commands into the remote shell. It looks for the repository by walking up from the File Manager's folder, or from your projects folder.
You can
- Initialize repository where you are, Add All and unstage everything.
- Write a commit message and Commit changes.
- Push, Pull, Fetch, Stash, Stash Pop.
- Switch branch or create one with New branch, and discard changes to a file.
You can't, and why
- A full
git difforreset: the local panel doesn't draw actions that JGit can't do. The panel's own footnote points to Source Control in the editor.By design - Sign in to a Git host from here: push and pull use the credentials already set up elsewhere in the app, and a failure shows its message in the sheet.By design
- Work on a repository outside your projects folder.By design
Processes
Panel tool Processes; menu → Linux Tools.
The running processes, read with ps.
You can
- See PID, name, user, CPU %, MEM % and state.
- Filter by name or PID (Filter processes…).
- Sort by CPU %, MEM % or PID.
- Stop a process with its kill icon, which types
kill -9 <pid>into the session. - Use the chips
top -n 1,ps aux --sort=-%mem | head -20anduptime, and refresh the list.
You can't, and why
- Pick another signal (it is always
-9) or filter by user.Not yet - Show a process tree.Not yet
System Info
Panel tool System Info; menu → Linux Tools.
Three tabs of cards: Overview (OS, kernel, uptime), Hardware (architecture, plus your phone's model, Android version and SDK level) and Environment (user and id).
You can
- Refresh the cards.
- Use the chips:
uname -a,uptime,whoami,free -handenv | sortsend what they say. cpuinfo sendscat /proc/cpuinfo, model sendsgetprop ro.product.model(falling back to the DMI product name), $PATH sendsecho $PATHand $SHELL sendsecho $SHELL.
You can't, and why
- Show memory, CPU or host name as cards of their own.Not yet
Disk Usage
Panel tool Disk Usage; menu → Linux Tools.
One card per partition, from df -hP, with a usage bar and the Used, Free and Total sizes.
You can
- Refresh the cards.
- Use the chips
df -h,du -sh * | sort -rh | head -20andfind / -size +100M 2>/dev/null.
You can't, and why
- See inodes or more than the columns of
df -hP.Not yet
Network
Panel tool Network; menu → Linux Tools.
Opening it runs ifconfig (or ip addr) and shows the result. The output appears in the sheet as plain monospace text, not in the session.
You can
- Pick a tool (
pingwith 5 packets,nslookup,traceroute,curlfor headers,wgetas a reachability check,dig), type a host, address or URL and tap Run. - Use the chips
ifconfig,netstat -tlnpandss -tuln.
You can't, and why
- Run
curlordigon the local shell: the BusyBox build doesn't include them, so they end with a not-found message.Google Play - Run anything for longer than 15 seconds or print more than 512 KB.By design
Environment Variables
Panel tool Environment Variables; menu → Linux Tools.
The variables, listed with env and searchable.
You can
- Add one with New Variable (the name must start with a letter or underscore and use only letters, digits and underscores). It is sent as
export NAME='value'. - Edit one with Edit Variable, or delete it, which sends
unset.
You can't, and why
- Be sure the list matches your open session: it is read by a separate shell, so a variable you
exportby hand may not show up.By design
Alias Manager
Panel tool Alias Manager; menu → Session.
Aliases for the session, listed with alias.
You can
- Create one with New Alias (letters, digits, underscore and hyphen in the name). It is sent as
alias name='command'. - Tap an alias to run it, or delete it (
unalias). - Tap one of the four Suggested aliases (
ll,cls,gs,..).gsisgit status, which the local shell can't run.
You can't, and why
- Keep aliases after the shell closes: PocketCode checks
.ashrcat every shell start and rewrites it if it differs from a fixed template, so edits to it don't survive.By design - Be sure the list matches your open session: it is read by a separate shell.By design
Background Jobs
Panel tool Background Jobs; menu → Session.
Jobs listed with jobs -l. When there are none the sheet says "No background jobs" and "Use command & to run in background".
You can
- Kill a job (
kill <pid>; a pid of 1 or lower, or the app's own, is refused). - Bring a job to the foreground (
fg %N).
You can't, and why
- See the jobs of the shell you are typing in: the list comes from a separate shell, so jobs you started with
&in your tab usually don't appear.By design
Snippets and history
Reusable commands and the commands you already ran.
Snippets
Panel tool Snippets (the one the panel opens with); menu → Snippets.
98 ready-made commands in 14 categories, seeded the first time the terminal runs, plus your own. On the local shell the six Packages snippets are hidden, so 92 show.
You can
- Filter by category chip (System, Docker, Git, Nginx, Node/PM2, Database, Security, Deploy/CI-CD, Monitoring, Network, Packages (SSH tabs only), Files, Text, Users, Custom) and by folder.
- Tap a snippet to put its command in the input bar. It is not run until you send it.
- Create one with New Snippet: name, command, category, description and folder. Generate with AI turns a sentence such as "find files larger than 100MB" into a snippet. It needs a connected AI provider and asks for consent the first time.
- Move a snippet to a folder, create or delete folders, and delete snippets.
- Use placeholders:
${DATE}(yyyy-MM-dd),${DATETIME}(yyyy-MM-dd_HH:mm:ss) and${TIMESTAMP}(milliseconds) are filled in when you tap the snippet.${HOST},${USER}and${PORT}are filled in on a tab opened from a saved host. Anything else is left as written, except the environment variables of a saved host's group or profile. - Save up to 10 snippets of your own on Free: the 98 built-in ones don't count toward the cap.
You can't, and why
- Keep more than 10 snippets of your own on Free. The 98 built-in ones don't count, so the + button (it carries a PRO mark) opens Terminal Pro only once you have 10 of your own. An import that carries snippets stops at the same cap.Pro
- See the Packages snippets on the local shell: there is no package manager to run them.Google Play
- Fill
${HOST},${USER}or${PORT}on a local tab: with no host they stay as typed.By design
Command History
Panel tool Command History; menu → Session.
The commands you sent from this tab's input bar.
You can
- Search with Search commands….
- Star a command to keep it under Favorites.
- Run a command again, or delete it.
- Tap Clear. The dialog says "This will remove all commands from this tab's history. Favorites will be kept."
You can't, and why
- Keep the history after the tab closes or share it between tabs: it holds the last 100 commands per tab and lives in memory.By design
- See what you typed straight into the shell: only commands sent from the input bar are recorded.By design
Automation (Pro)
Quick Scripts, Keyboard Macros and Expect Rules are Pro: the gate is on saving them, and on running a Quick Script. On Free the sheets open, show a PRO mark, and Terminal Pro appears when you try to save. The paywall lists them as Advanced automation (Expect rules, Watchdog, Macros).
Quick Scripts
Panel tool Quick Scripts; menu → Automation.
Multi-line scripts that you send to the session with one tap.
You can
- Create a script with New Script (name, description and the script text), search them, edit and delete.
- Tap Run: each line is sent to the session with 150 ms between lines. Blank lines and lines that start with
#are skipped.
You can't, and why
- Save or run a script without Pro.Pro
- Stop a script halfway, or sort scripts by category: there is no stop button and the form doesn't ask for a category.Not yet
Keyboard Macros
Panel tool Keyboard Macros; menu → Automation.
A named sequence of keys that is sent to the session as raw bytes.
You can
- Add macro: a name, the Key sequence and an optional description.
- Tap a macro to send it, or delete it.
- Use these escapes in the sequence, and only these:
\n(Enter),\t(Tab),\x1b(ESC),\x03(Ctrl+C),\x04(Ctrl+D) and\x1a(Ctrl+Z).
You can't, and why
- Create a macro without Pro.Pro
- Put macro buttons on the input bar: macros run only from this sheet.Not yet
Expect Rules
Panel tool Expect Rules; menu → Automation.
When a pattern shows up in the output, PocketCode types a response for you. Rules are checked line by line on the output of every open session, and only the first rule that matches a line answers.
You can
- Add rule: a Pattern to detect, Use regex (off means the line contains the text, ignoring case; on means the regular expression is found anywhere in the line), an Automatic response and a description.
- Switch a rule on or off, or delete it.
You can't, and why
- Create a rule without Pro.Pro
- Add a line break to the response: PocketCode already presses Enter after it (the sheet says "Response will be sent automatically + Enter"), so a
\nwould send it twice.By design
Profiles
Profiles are the least finished part of the terminal. They are listed here because the sheet is in the panel and the menu.
Panel tool Profiles; menu → Security.
A list of Terminal Profiles. Five come with the app: Default, Bash, Dev (Node), Docker and Python Env.
You can
- Create, edit, duplicate and delete profiles, and mark one as the default.
- Fill in name, shell type, shell path, working directory, theme, font size, startup commands, environment variables, scrollback, bell, icon and color.
- Tap Launch to open a tab and send the profile's startup commands.
You can't, and why
- Keep a profile: profiles are not written to storage, so don't count on them after the app restarts.Not yet
- Have the shell type, theme, font, environment or working directory applied: Launch does little more than open a tab and send the startup commands.Not yet
- Create a profile for an SSH host: the form has no host picker.Not yet
- Run the factory profiles' commands: Docker and Python aren't in the local shell.Google Play
Recording and logs
Two ways to keep what a session printed. Both are Free.
Recording
Panel tool Recording; menu → Session → Start Recording.
"Saves the session as an asciinema .cast file you can replay later." The file is asciicast v2, named session_<name>_<date>.cast, and is not encrypted.
You can
- Start Recording and Stop Recording on the focused tab. The REC chip shows while it runs.
- See your files under Saved recordings.
- Find a recording in Session Logs too: it is saved in the same store, so you can bookmark and share it there, and it counts toward the cap of 100.
You can't, and why
- Replay a recording inside the app: it is only listed. Replay it with asciinema elsewhere.Not yet
Session Logs
Panel tool Session Logs; menu → Settings.
A plain-text log of everything a session printed, stored encrypted on the device (AES-256-GCM, with a key held in the Android Keystore). The plain text exists only while logging; when you stop, the file is sealed.
You can
- Start Logging and Stop Logging. The LOG chip shows while it runs.
- Use Bookmark on a log (a star), add a Comment ("What happened, why it matters") and show Bookmarked only.
- Share a log: it is decrypted to a temporary copy and handed to the system share sheet.
You can't, and why
- Keep more than 100 logs: the oldest are dropped, except the ones you bookmarked.By design
- Search logs by text or date: you only see each log's date and the bookmarked filter.Not yet
Share your dev server
A public link to the dev server running on your phone.
Panel tool Share your dev server; menu → Session.
With a dev server running on the phone (started from a project), the sheet reads "Give a public address to the server running on this phone, on port N". The link goes out through an SSH remote forward to localhost.run: no account and no extra software.
You can
- Tap Create link, then Copy link. If it fails, Try again.
- Tap Stop sharing whenever you want. The link also closes by itself when the dev server stops.
You can't, and why
- Share without a server: the sheet says "No dev server is running. Open a project first."By design
- Keep the same address or use your own domain: the link is temporary ("it changes each time and ends when you stop sharing") and anyone with it can reach the server while sharing is on.Third party
- Share while offline.Needs network
Explain with AI
Plain-language help when a command fails.
The sparkle button (Explain with AI) in the input bar. It appears only when the latest output looks like a failure.
PocketCode sends the last 40 lines of the tab (8 KB at most) to your connected AI provider, with secrets masked first, and shows the answer in AI explanation: what failed, why, and what to run next. It waits up to 60 seconds. You use your own provider, so it costs PocketCode nothing.
You can
- Read the explanation and tap Copy the explanation.
- Read the line under the title: "The last 40 lines are sent to your connected AI provider, with secrets redacted."
You can't, and why
- Use it without an AI provider connected in Settings: the sheet says "No explanation came back. Check that you have an AI provider connected in Settings and try again."Needs network
- Run the command the AI suggests from a button: the sheet only shows and copies it. The text is not saved.By design
Appearance
Colors and fonts are not set in the Terminal itself.
- In Settings, under Appearance, open Terminal appearance: theme, font, text size, wallpaper and background opacity.
- There are 11 terminal themes plus Same as app, which follows the app (12 cards in the picker). Five are free (Same as app, PocketCode Dark, PocketCode Light, Dark and Light) and seven are Pro (Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark and Nord). Terminal themes installed from the Marketplace are Pro too.
- Pinching the output also changes the text size (8 to 24).
SSH, SFTP and remote tools
The SSH screen, SFTP and everything remote have their own page. They share the tab bar, the panel and the menu you have just read about, with 12 more tools (32 in all).
- Where it lives: hosts and groups, Quick Connect, host keys and keyboard-interactive login, SSH keys (including keys bound to the device), SFTP, port forwarding, Watchdog, Webhooks, the package manager, cloud providers, serial and remote desktop.
- Also in this panel: Sync & Teams and Import / Export appear in the local tool list too. They are described on the SSH page. In Sync & Teams, hosting, looking for or joining a Team Room makes Android ask for the local-network (nearby devices) permission on Android 13 or later, and the explanation of that permission and the connection errors appear in the language of the app.
- Pro on remote tabs: a second saved host, a second port forward, Broadcast, Watchdog and Webhooks. Their limits are on the SSH page.
Free and Pro
What the local terminal gates. Everything else is Free.
| Feature | Free | Pro |
|---|---|---|
| Live sessions at once, per screen (Terminal and SSH each have their own slot) | 1 | No limit |
| Split view | Not included | Included |
| Create Keyboard Macros, Quick Scripts and Expect Rules (and run Quick Scripts) | Not included | Included |
| Your own snippets | Up to 10; the 98 built-in ones don't count. Past 10, adding or importing one opens Terminal Pro | No cap |
| Terminal themes | 4 built-in plus Same as app | All 11 plus Same as app, plus themes from the Marketplace |
| Terminal fonts | Default only | Default plus 7 more |
| Local shell, Linux tools, Git Panel, history, aliases, environment, recording, session logs, Share your dev server, Explain with AI, Profiles | Included | Included |
Privacy and security
- The local shell runs with PocketCode's own permissions and is not a sandbox. A notice (About this terminal) says so the first time you use it.
- Your projects are in
~. The tool sheets stay inside that folder and never open the folders that hold app credentials. - Session logs are encrypted on the device with AES-256-GCM and a Keystore key. Recordings are plain
.castfiles. Sharing a log decrypts it to a temporary copy. - Command history is kept in memory, the last 100 commands per tab, and is not written to disk.
- A command you send from the input bar that reads a credentials store and also sends data out raises a warning before it runs.
- A program can't write to your clipboard without a confirmation (OSC 52).
DATABASE_URLand thePG*variables of the local PostgreSQL engine are set in the local shell only, and only while the engine runs. They are never sent to SSH sessions.- What leaves the device on purpose: Explain with AI sends the last 40 lines, with secrets masked and after a one-time consent, to the AI provider you connected. Generate with AI in snippets sends your sentence to the same provider. Share your dev server goes through localhost.run while sharing is on.
Limitations
The main limits of the local terminal, each with its reason. The detail is in the sections above.
- Programs that redraw the screen (
vi,top,less) don't display as a screen.By design - In the basic shell: no package manager,
git,python,docker,curl,sshorzip.Google Play - No root and no Linux distribution: the shell has the app's own user.Device
- PocketCode runs on 64-bit devices (arm64-v8a and x86_64) with Android 9 or later. There is no 32-bit build.Device
- One live session per screen on Free, and no split view, macros, scripts or expect rules.Pro
- There is no row of extra keys (ESC, TAB, Ctrl, F1 to F12), and file paths in the output don't open.Not yet
- Profiles aren't saved and most of their fields aren't applied; recordings can't be replayed in the app.Not yet
- The environment, alias and job lists are read by a separate shell, not your open session.By design
- On a wide tablet with the panel docked, the tools menu (and its Volume Keys switch) isn't shown.Device
- A Share your dev server link is temporary and needs a connection.Third party
Troubleshooting
Basic shell
The Local Shell card says Basic shell when it can't find BusyBox's ash yet. BusyBox is linked the first time you open a shell, and again after an app update, so open the local shell once and come back: it should then say Busybox tools ready. Until then you have Android's own sh, which lacks applets such as awk and tar.
Terminal Pro
You asked for something Free doesn't include: a second session on the same screen, split view, saving a Keyboard Macro, Quick Script or Expect Rule, adding an 11th snippet of your own or, on SSH, a second saved host or port forward. Continue with basic plan closes the wall; Unlock Terminal Pro opens the paywall.
The + on Snippets opens Terminal Pro
You already have 10 snippets of your own, the Free cap; the 98 built-in ones don't count. Delete one to make room, or unlock Terminal Pro. You can still tap any built-in snippet to use it.
No Git repository here
The Git Panel looks for a .git folder from the File Manager's current folder upwards, or from your projects folder. Open the File Manager in your project folder, or tap Initialize repository.
No explanation came back. Check that you have an AI provider connected in Settings and try again.
Explain with AI needs a provider with a key or login. Connect one in the AI settings and try again. It also gives up after 60 seconds.
Couldn't generate a snippet — try rephrasing
Generate with AI expects one request in a sentence and answers with a name, a one-line command and a description. Say what you want to do, not the command you imagine.
No dev server is running. Open a project first.
Share your dev server shares the dev server your project started. Start the server from the project first; the sheet then shows its port.
Command reads credentials and sends data out
The command you are about to run touches a credentials store and also sends data to the network. If you copied it from somewhere, read it before tapping Run anyway.
Copy to clipboard?
A program in the session asked to put text on your clipboard. Tap Copy only if you asked for it.
Open a shell or connect to a host to record
Recording records the focused tab. Open a local shell first, then start it.
Could not attach file / Could not prepare log for sharing
The file couldn't be copied into the session, or a log couldn't be decrypted for sharing. Try again; if it keeps failing, pick another file or stop and restart the log.
There is no Explain with AI button
The button only appears when the latest output looks like a failure. Run the command that failed again, or read the explanation from the last failing output.
My alias or variable is gone in a new shell
Aliases and variables you create from the sheets live only in that session; PocketCode restores .ashrc on every start. Put a repeated command in a Quick Script (Pro) or a snippet instead.