Workspace and Git
After reading this page you will be able to: browse project files in the workspace, stage or discard AI’s changes one by one, and jump to external tools in one click.
The workspace is the project panel on the right of the chat: a file tree of the current project on one side, a Git view of its changes on the other. It appears with the session — give the session a project and it is there.
1. Opening and collapsing
Section titled “1. Opening and collapsing”Once a session has a project, the workspace panel appears right of the chat area with two tabs:
| Tab | Shows |
|---|---|
| Files | The current project’s file tree |
| Changes | AI’s changes to project files, as Git sees them |
Press Ctrl+L (⌘L on macOS) to collapse or expand the workspace anytime, freeing space for the conversation.
2. What the file tree can do
Section titled “2. What the file tree can do”In the Files tab:
| Action | How |
|---|---|
| Search | The top box “Search files by name”; too many hits suggests narrowing down |
| Create | Right-click empty space or a folder → “New file” / “New folder” |
| Rename / Delete | Right-click a file → “Rename” / “Delete”; deleting confirms “Delete “××”? This can’t be undone.” |
| Drag import | Drag files or folders from the system into the panel to copy them into the project |
| Copy paths | Right-click → “Copy relative path” / “Copy absolute path” |
| Add to chat | Right-click → “Add to chat”; the file goes into the input box as a reference |
| Open | Right-click → “Open” with a system app, or “Show in folder” |
| Refresh | Right-click → “Refresh” to re-read the disk |
A project can hold several folders: click Add folder to project at the panel’s top right to add one, right-click an unneeded folder and choose Remove from project.
3. The Changes panel: what AI touched
Section titled “3. The Changes panel: what AI touched”Switch to the Changes tab for a Git view of every change (the project must be a Git repository; otherwise it says “This folder is not under version control”):
- Each repository gets one row with its current branch name on the right; in a multi-repo project, switch between them in the repository list at the top
- Changes are grouped into Staged changes and Changes (unstaged)
- Each file carries a status badge:
| Badge | Meaning |
|---|---|
| A | Added |
| M | Modified |
| D | Deleted |
| R | Renamed |
| ! | Conflict |
| ? | Unrecognized state |
Per file: Stage changes, Unstage changes, Discard changes; whole groups can be staged or discarded too. Click a file name to open its Diff in the preview panel (added lines marked +, removed lines −).
4. Opening outside the app
Section titled “4. Opening outside the app”The Open project folder button at the panel’s top right hands the project to an external tool:
| Option | Effect |
|---|---|
| VS Code | Opens the project in VS Code (requires VS Code installed) |
| Terminal | Opens the project directory in a system terminal |
| File Explorer | Opens it in the system file manager |
| Browser | Opens the project preview in AIPC UP’s in-app browser (see Preview Panel) |
Whichever you pick is remembered; next click on the button takes the same route.
5. Where the workspace fits
Section titled “5. Where the workspace fits”The workspace is not a replacement for a full Git tool: it covers the everyday handful — view changes, stage, discard, read diffs. Branch management, merging, and history are better done in dedicated tools; “Open project folder” gets you there in one step.
How to tell it worked
Section titled “How to tell it worked”- With a project attached you can see the file tree, and
Ctrl+Lcollapses and expands it - Dragging a file into the panel makes it appear in the tree
- After AI edits a file, the Changes tab shows an M badge and the Diff opens for review
- You can stage a change and open the project in VS Code via “Open project folder”