← All docs

Workspace & sources.

The workspace: your clone's home

The workspace is a plain folder on your disk where your clone files what you share with it. Nothing exotic: markdown files you can open with any text editor, fully compatible with Obsidian if you use it.

The loop is simple. You share, your clone files it. You never write a special format and you never reorganize anything.

Left to itself, your clone files things using PARA: an inbox for quick capture, then Projects, Areas, Resources, Archives. That is its filing habit, not your homework, and it is entirely optional. If you already keep a notes folder, point Klyr at it during setup and choose "keep my folder exactly as it is": it works inside your layout without moving or renaming a thing. The one thing it adds, when your folder is not already inside a git repository, is a hidden .git folder. None of your notes is ever committed, and a folder that is already in a repository is left as it is.

Sources: read-only places it watches

Sources are the opposite direction: folders your clone reads but never touches. Configured folders, like a mirror of your Google Drive, land in the workspace as read-only copies so their content becomes part of your clone's memory.

Google Drive is available today: see Connectors. More configured sources are coming.

Everything is plain files you own

The workspace is not a database and not a proprietary format. It is markdown on your disk. Copy it, back it up, open it in another app, leave with it. Your clone reads and writes there; it never holds your notes hostage.