Docs

Getting started

What Gradient is, what happens on first launch, the screen map and projects

Getting started

At a glance

Principle Meaning
Files are the source Notes, diagrams and imported documents are all files in the project folder. The search index and chat history database are by-products that are rebuilt if deleted
Only AI calls are irreversible Everything else can be undone. The index is rebuilt by reindexing; the originals stay as files
Data on this computer, intelligence over the network Files, search and reading work offline. Only AI answers need a connection
Keys stay on this device Account tokens are stored only on this computer and never reach the screen layer

First launch — getting components ready

On first launch three helper components are downloaded: media converter (ffmpeg) · browser engine (Chromium) · diagram editor (draw.io). A progress bar shows; on failure press [Retry], and when done review the license notice and press [Continue]. The app does not open until everything is ready.

Later, check status or download again under Settings → Components. Fonts for slides and documents (Noto Sans KR) are downloaded there separately.

Screen map

Menu What
Chat Talk with AI. It searches project files and the web for answers and can turn a conversation into a note
Team Rooms for talking with people in your company. Messages and files stay on the writer’s device
To-do Shows the checkbox lines inside plans (md files) as to-dos and lets you answer teammates’ requests
Files Where everything lives — import, search, view, edit, summarize, export
Diagrams A draw.io canvas. The AI in the side chat draws on it directly
Browser A browser inside the app
Market · Workflows · Monitoring Installing features (verticals), workflows that fill a template document from your materials, what chat turns and workflow runs did and how much AI they used
Playground Images, Image Editor, Screen share, File transfer, Lineage graph and installed verticals
Settings Language, account, AI memory, search, secure sharing, host PC, components, storage, contact, about (updates)

Tools in the header (search, notifications, notes, files drawer…) are covered in the Header document.

Projects

Click the project name at the top of the sidebar to switch projects or create one. Each row shows a dot for the current project, the project name and its team name. A new project starts as an empty document folder — fill it with chat, canvases and imports. Switching projects reopens every screen for that project.

Numbers and paths

  • A project lives in ~/plm-workspace/{project}/; the documents the Files tab shows are in its docs/ folder. Settings → Storage opens these folders.
  • Documents the app creates are numbered: notes NOTE-00001 · diagrams DG-00001. The next number comes from counting the files in the folder.