You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/05-file-management.md
+103-1Lines changed: 103 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -201,7 +201,7 @@ When you right-click a tab, a context menu appears which has multiple options so
201
201
202
202
> These options provide quick access to common file operations directly from the Tab Bar.
203
203
204
-
####Git - Tab Bar
204
+
### Git - Tab Bar
205
205
The Tab Bar displays Git file status indicators, showing which files are **untracked** or **modified**.
206
206
207
207

@@ -210,3 +210,105 @@ The Tab Bar displays Git file status indicators, showing which files are **untra
210
210
- An **orange marker** indicates a **modified** file.
211
211
212
212
> These indicators appear only when your project is a Git repository.
213
+
214
+
---
215
+
216
+
## Working Files
217
+
**Working Files** (also called **Working Tree**) provides another way to view and manage open files. It appears in the sidebar, above the **File Tree**.
Working Files and Tab Bar are synchronized which means that any operation performed on one (closing, reordering, opening files, etc.) is automatically reflected on the other.
222
+
223
+
Working Files displays the same UI elements as the Tab Bar:
224
+
*`•` icon for unsaved files
225
+
*`×` button to close files
226
+
* Parent folder names when multiple files have the same filename
227
+
* Tooltip showing full file path on hover
228
+
* Git status indicators (green for untracked, orange for modified files)
229
+
230
+
> See the [Tab Bar](#tab-bar) section for detailed explanations of these features.
231
+
232
+
> **Note**: Unlike Tab Bar, you cannot control the maximum number of files displayed in Working Files.
233
+
234
+
### Working Files in Split Panes
235
+
When using split panes, each pane maintains its own list of open files in Working Files.
236
+
237
+
The panes are labeled based on the split orientation:
238
+
***Vertical Split**: *Left* (first pane) and *Right* (second pane)
239
+
***Horizontal Split**: *Top* (first pane) and *Bottom* (second pane)
You can show or hide the Working Files panel in two ways:
252
+
253
+
#### 1. From the Sidebar
254
+
Click the **double-arrow** icon in the top-right corner of the sidebar, then use the `Show Working Files` option in the dropdown to toggle Working Files.
255
+
256
+

257
+
258
+
#### 2. From Preferences
259
+
You can also toggle Working Files by updating the `showWorkingSet` property in the preferences file.
260
+
```json
261
+
"showWorkingSet": true
262
+
```
263
+
Set the value to `false` to hide Working Files.
264
+
See [Editing Preferences](./editing-text#editing-preferences) if you need help editing the preferences.
265
+
266
+
### Working Files Context Menu
267
+
When you right-click a file in Working Files, a context menu appears with various file operations.
***Download** — Downloads the file to your local system. *This option is available only in the browser version.*
290
+
291
+
***Rename** — Allows you to rename the file. When you choose this option, **Phoenix Code** highlights the file in the File Tree so you can rename it directly.
292
+
293
+
***Delete** — Deletes the file from the project and removes it from Working Files.
294
+
295
+
***Find in...** — Opens the Find dialog to search for text within the selected file.
296
+
297
+
***Replace in...** — Opens the Find and Replace dialog to search and replace text within the selected file.
298
+
299
+
***Close** — Closes the selected file and removes it from Working Files.
300
+
301
+
***Close Files Above** — Closes all files above the selected one in the Working Files list. *This option is disabled when there are no files above the selected file.*
302
+
303
+
***Close Other Files** — Closes all files except the selected one. *This option is disabled when the selected file is the only open file.*
304
+
305
+
***Close Files Below** — Closes all files below the selected one in the Working Files list. *This option is disabled when there are no files below the selected file.*
306
+
307
+
***Add to .gitignore** — Adds the selected file to the `.gitignore` file, preventing it from being tracked by Git. *This option appears only when your project is a Git repository.*
308
+
309
+
***Remove from .gitignore** — Removes the selected file from the `.gitignore` file, allowing it to be tracked by Git again. *This option appears only when your project is a Git repository.*
310
+
311
+
> These options provide quick access to common file operations directly from Working Files.
0 commit comments