Appearance
Files & storage
klars stores workspace records and artifacts on the computer running its local service. Desktop and browser clients can use the same service and store.
Service and customization files
Paths below are defaults. Settings shows the active configuration and customization locations when you use a custom setup.
| Location | Contents |
|---|---|
~/.klars/app/ | The private local service data directory. |
~/.klars/app/workspace.sqlite | Workspace records such as projects, conversations, captures, and runs. |
~/.klars/app/artifacts/ | Saved graph artifact files. |
~/.klars/app/server.json | Private discovery record for the running service. |
~/.klars/app/secrets/ | Encrypted credentials and vault key material. |
~/.klars/config.yaml | Global klars configuration. |
~/.klars/ui/ | Theme, layout, custom CSS, and customization history. |
<project>/.klars/project.yaml | Project configuration when saved through klars. |
~ is your user home directory, including on Windows. Local project source stays in the folder you opened. GitHub sources are cloned into a managed folder on the service machine.
Change a location
KLARS_DATA_DIRorklars serve --data-dir PATHselects a service store.KLARS_HOMEselects the global configuration/customization home; it does not by itself move the service store.KLARS_CONFIGselects a global configuration file.KLARS_PYTHONselects a service Python interpreter at launch.
A custom data directory has its own service discovery. Training processes relying on the default discovery record will need an explicit address and credential.
Desktop logs
| Platform | Service log |
|---|---|
| macOS | ~/Library/Application Support/klars/service.log |
| Windows | %APPDATA%\klars\service.log |
These logs belong to the desktop host. A terminal-launched klars serve reports startup diagnostics in that terminal.
Local view preferences
Theme choices, onboarding tips, panel preferences, and project resume markers use browser-profile storage. They can differ between browser profiles or between desktop and browser even when workspace records come from the same service.
Resetting a view preference is different from deleting the service store. Automatic cloud synchronization is not provided.
Back up deliberately
Quit the owning app or stop klars serve before copying its private data directory. Keep your project source and required model files with your normal project backups. Protect credential material and backups with the same care as the original store.
Use Export graph for a selected graph artifact and customization Export for appearance settings; neither is a complete workspace backup.