Open Settings
Cmd, (Ctrl, on Windows and Linux), the account menu's Open Settings, or Preferences: Open Settings in the command palette. The search box at the top finds a setting by name. Changes apply at once.
In Code, Settings has these sections. Visual shows a shorter list for people building apps (Visual settings).
Account
Your name and email, Switch account, Sign out, your current plan and Piye credits (left, this period, carried over, Starter, bought). See Sign in and your account.
General
| Setting | What it does | Default |
|---|---|---|
| Interface size | Piye's own screens drawn smaller or larger; your code keeps its font size | Default |
| Times on chat messages | Beside each message: how long ago ("3 minutes ago"), the clock time, or none | How long ago |
| Auto Save | Save changed files after a short delay, the same way as CmdS | On |
| Save Delay | The delay before auto save, in milliseconds | 1000 |
| Start in | Which side of Piye you land in: Visual, Code, or Last used | Last used |
| Open on Startup | Last project, Welcome screen, or Empty editor | Last project |
| Restore Windows | Reopen this window at its last size and position | On |
Editor
These change the file you have open: Theme, File icons (Material Icon Theme), Font size (14), Font (JetBrains Mono), Line height (1.65), Tab size (2, unless the project says otherwise, in .editorconfig or Prettier), Word wrap (on), Line numbers (number, distance from the cursor's line, or none), Minimap (on), Sticky scroll (on) and Matching bracket colours (on). See The editor.
Languages
One page per language: open a language to change how its tools treat the open file, such as its own tab size or formatter. Each language's server can be turned on or off, with its own options and its log. See Languages and code intelligence.
Code Intelligence
| Setting | What it does |
|---|---|
| Suggestions as you type | Piye's AI writes the next lines in gray; Tab takes them, Esc lets them go. Uses credits. |
| Problems at the end of their line | An error or warning written faintly where it happens, besides the Problems panel (on). |
| ESLint | The project's own ESLint rules checked as you type, with fixes one click away (on). |
| Python type checking | How strictly the Python language server (Pyright) checks types. |
| Auto imports | Completions from any file or package in the project; picking one adds its import (TypeScript, JavaScript). |
| Inline hints | Parameter names and types written faintly inside the code. |
| References above functions | How many places use a function or class, above it (CodeLens, on). |
| Colours from the language server | Variables, parameters and types coloured by what they are. |
| Format (on save) | The project's own Prettier, else the language's formatter. |
| Sort and clean the imports (on save) | Unused imports taken out, the rest in order. |
| Fix what can be fixed (on save) | Every safe fix from ESLint and the language server. |
| One language at a time | Each language's server: on or off, its options, its log. |
Keymap
Every command with its keys. Find a command by name or by keys, click Edit and press new keys, Reset to go back to Piye's. See Keyboard shortcuts.
Snippets
Your snippets: a trigger word, a description and the text it puts in, with $1, $2 tab stops. See The editor.
Window & Layout
| Setting | What it does |
|---|---|
| Window Layout | Editor + Panels, Editor Only, or Agent Focus (keeps the chat, hides Explorer and terminal) |
| Restore Windows | Remember the window's size and position on quit |
Panels
| Group | Setting | What it does |
|---|---|---|
| Explorer | Sidebar Width | The Explorer's default width, in pixels (288) |
| Deploy | Show AI assist | The ask-the-agent controls in Deploy |
| Deploy | Remember last view | Reopen Ship, Docker or History as you left it |
| Deploy | Default view | Ship, Docker engine or History |
| Deploy | Expand log while deploying | Grow the log while a job runs |
| Apps | Remember last tab | Reopen Project, Devices, Stores or Setup as you left it |
| Apps | Default tab | Which Apps tab opens first |
| Apps | Setup hints | The toolchain hint on the Setup tab |
| Operations | Show critical / warnings / info | Which alerts the Operations panel shows |
| Operations | Show watching | List the hosts, CI and stores Operations watches |
| Operations | Auto refresh | Check live hosts on a timer |
| Operations | Refresh interval | Seconds between checks: 300 (five minutes) by default, 60 at least |
Version Control
| Setting | What it does | Default |
|---|---|---|
| Status in the file tree | Changed, new and ignored files marked in the Explorer | On |
| Changed lines beside the code | Added, changed and removed lines in the gutter | On |
| Who changed this line | The author and when, at the end of the cursor's line | On |
| Name / Email | Who your commits come from (your Git settings, for every project) | |
| Sign off commits | A Signed-off-by line on each commit Piye makes | Off |
| Commit every change when nothing is staged | Off: stage files first, one by one | On |
| Write the message from the chat | In Piye Studio, the commit message starts as what you asked the chat | On |
| First branch of a new project | The branch a new project starts on | |
| When you pull | Merge, or Rebase | Merge |
| Check the remote for new commits | Fetch while a project is open, so Source control shows what to pull | Off |
Handoff
Invite people and manage access, Open an invite (paste a link), Bring your chats from Claude Code, Cursor and Codex, and Allow invites. See Handoff from Code.
AI
| Setting | What it does |
|---|---|
| Disable AI | Turns off the agent, Tab suggestions and the terminal's AI |
| Default Model | The model new chats start with (Claude Sonnet 5) |
| AI answers in | The language the AI writes to you in, whatever you write in; code and file names stay as they are |
| Personal API keys | Your Anthropic, OpenAI, Google, xAI or Mistral keys |
| MCP Servers | Opens Integrations |
| Local Ollama | Use local Ollama and its Ollama URL (http://127.0.0.1:11434) |
| Catalog | Every model, recommended first, with what each uses; set the default from a row |
| Only API keys | When signed in: run Code's AI only on your own keys, never credits |
| Agent Mode | Off keeps the chat in Ask (read only). On lets you switch to Build, Architect and Debug |
| Context | How much of the editor goes with each message: Minimal (message only), Balanced (active file), Maximum (file and its problems) |
| File changes | Review each file, or Auto-apply creates and edits. See Review, Auto and undo |
| How Visual builds | Visual's build mode: Fast, Auto or Customize |
| Check Visual's apps | After Visual writes files: install packages with install scripts off, run the type check, and fix what it finds |
| Submit with Cmd+Enter | CmdEnter sends; Enter adds a line |
The AI section also shows your usage, Piye Cloud and your Piye credits. See Models, effort and keys.
Integrations
Connected providers and services:
- Outside agents: Claude Code and Codex, with their sign-in state. See Claude Code and Codex.
- App stores: your App Store Connect and Google Play connections.
- Operations: the services Operations reads.
- MCP: servers Connected and Available to connect, with Add a server, Reload from mcp.json, Reveal mcp.json and remove. See MCP and the Marketplace.
iPhone and Android
Where the iPhone simulators and Android emulators stand on this computer, and what's left to download. See Simulators and devices.
Free up space
What Piye downloaded (phone software, tools, caches, build folders) and their size, with a button to remove what's safe.
Developer
Privacy & Security
| Setting | What it does |
|---|---|
| Telemetry | Reserved. Piye sends no usage data today |
| Agent commands in a sandbox | Run the agent's commands in the system's sandbox (on). See Security |
| Where your keys are kept | Shown only on Linux without a keyring |
| Ask before trusting a folder | The "Trust this folder?" card for folders from outside Piye (on) |
| Code Indexing | Attach a project tree snapshot to each agent turn; off sends less of the repository (on) |
| Data Retention | How long chats are kept: 30 days, 90 days (default), 1 year, or forever |
| Privacy Mode | Block Piye Cloud and personal API keys; local Ollama still works |
Updates
Check for Updates, Auto-Update (on) and View Changelog. See Updates.
About Piye
The version, which Piye Cloud it uses, links to the web app, documentation, community and support, the Terms and Privacy Policy, and the open-source notices.
settings.json
Settings can also be edited as JSON: Preferences: Open settings.json.
- Yours lives in Piye's own folder and applies to every project.
- A project's is
.piye/settings.json, which applies over yours in that project only.
Unknown keys are kept as they are and ignored.