@samitouri / QOSami_Agents_Zero
Code Commits Issues Pulls Sessions CI/CD
main
main
md 126 lines 4.43 KB
Rendered Raw
1 # Desktop Guide
2
3 Agent Zero has its own Linux desktop inside the right-side Canvas.
4
5 Open it by clicking the **Desktop** icon in the Canvas rail. The surface starts
6 an XFCE desktop that Agent Zero can also control when a task needs a real GUI.
7
8 ![Desktop Canvas](../res/usage/webui/desktop-canvas.png)
9
10 Use the Desktop when the work is visual: opening Linux apps, inspecting files in
11 a file manager, checking a document layout, or LibreOffice Cowork.
12
13 For architecture and source-linked internals, use
14 [DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero). This page
15 is the practical tour.
16
17 ## What The Desktop Is For
18
19 The Desktop is a live Linux workspace. You can use it yourself, and Agent Zero
20 can use its Linux Desktop skill to observe the screen, act through the GUI, and
21 verify what changed.
22
23 Good uses:
24
25 - open the graphical file manager for `Workdir`, `Projects`, `Skills`, `Agents`, or `Downloads`;
26 - run Linux GUI apps that are available in the Agent Zero environment;
27 - open a terminal when a visual terminal session is useful;
28 - inspect or polish LibreOffice Writer, Calc, and Impress files;
29 - Cowork with the agent in a document, spreadsheet, or presentation.
30
31 For normal web browsing, use the **Browser** surface instead of launching a
32 browser inside the Desktop. The Browser surface has dedicated page inspection,
33 screenshots, history, annotations, and host-browser support.
34
35 ## Start From The Canvas
36
37 The Desktop lives next to the Browser surface in the Canvas.
38
39 1. Open Agent Zero.
40 2. Click the **Desktop** icon on the right Canvas rail.
41 3. Wait for the desktop to finish starting.
42 4. Click **Open as window** if you want more room.
43
44 The first start after an update can take longer while the Desktop gets ready.
45 After that, it normally opens much faster.
46
47 ## Create Or Open Files
48
49 The Desktop toolbar has a **New** menu.
50
51 ![Desktop New menu](../res/usage/webui/desktop-new-menu.png)
52
53 Use it to create:
54
55 - **Markdown** for notes, drafts, and simple documents;
56 - **Writer** for LibreOffice text documents;
57 - **Spreadsheet** for LibreOffice Calc workbooks;
58 - **Presentation** for LibreOffice Impress decks.
59
60 Use **Open** when you already have a file in the Agent Zero workspace.
61
62 Agent Zero usually creates document files through its document tools first, then
63 lets you open them in the Desktop when you want to inspect or polish them. That
64 keeps content changes reliable while still giving you the full GUI when it
65 matters.
66
67 ## Cowork In LibreOffice
68
69 LibreOffice Writer, Calc, and Impress run inside the Desktop.
70
71 ![Writer in Desktop](../res/usage/webui/desktop-writer.png)
72
73 You can type directly in the app, save, rename, and close the file from the
74 Canvas header. Agent Zero can also work with the same file: it can create the
75 first draft, update cells, revise slides, or use the visible Desktop to check
76 layout before reporting back.
77
78 Good prompts:
79
80 ```text
81 Create a Writer document for this meeting note and open it in Desktop so I can edit with you.
82 ```
83
84 ```text
85 Open this spreadsheet in Calc, add a small summary table, save it, and show me the result in Desktop.
86 ```
87
88 ```text
89 Create a short Impress deck, then use Desktop to check that the slides look clean.
90 ```
91
92 For default formats, think:
93
94 - Writer -> ODT;
95 - Calc -> ODS;
96 - Impress -> ODP.
97
98 Ask for DOCX, XLSX, or PPTX only when you need Microsoft Office compatibility.
99
100 ## How Agent Zero Uses It
101
102 When you ask for Desktop work, Agent Zero uses a careful loop:
103
104 1. create or edit the file in the most reliable way;
105 2. open the Desktop only when the GUI is useful;
106 3. observe the visible state;
107 4. act through the app when needed;
108 5. save and verify the result.
109
110 This means the Desktop is not just a remote screen. It is a shared workspace
111 where the agent can do GUI work and you can take over at any time.
112
113 ## Practical Tips
114
115 - Use **Open as window** for large Writer, Calc, or Impress sessions.
116 - Save before closing if you edited by hand.
117 - Use Markdown for quick notes and drafts unless you need a LibreOffice file.
118 - Use Writer, Calc, or Impress when layout, formulas, charts, or slide polish matter.
119 - If a GUI app feels stuck, ask Agent Zero to verify the Desktop state before continuing.
120 - Keep the Browser surface for websites and the Desktop surface for Linux apps.
121
122 ## Related
123
124 - [Browser Guide](browser.md): web pages, screenshots, annotations, and host-browser mode.
125 - [Memory Guide](memory.md): what to check when behavior keeps repeating in an unwanted way.
126 - [Usage Guide](usage.md): the main Web UI workflows in one guided tour.