EGGENT docs
Eggent Cloud

Files on your computer

How to keep your cloud Eggent's projects folder on your computer as an ordinary folder, synced both ways with Syncthing.

Your cloud workspace's projects folder can live on your computer as an ordinary folder: change it here and it changes there, and the other way round. It works through Syncthing, a free open-source program.

What it is good for:

  • opening the agent's results in the programs you know: Word, Excel, Obsidian, a code editor;
  • dropping material into a folder on your computer instead of uploading it through the browser;
  • keeping a copy of all your files.

What is synced

Only the projects folder (data/projects): the orchestrator's files and every project. Chats, settings, keys and system folders (.pi, node_modules) are not synced, and neither is .mcp.json, since it may contain tokens.

Sync works even while the workspace is asleep.

Connect a computer

Open https://cloud.eggent.ai/sync/name and sign in with the same email and password as the workspace. Then four steps, once per device:

  1. Install Syncthing from syncthing.net and leave it running in the background.
  2. Tell us your device id. In Syncthing: Actions → Show ID; copy the long code and paste it on the page.
  3. Add the server in Syncthing. In Syncthing press Add Remote Device and paste the server id from the page. Tick the box saying you have added it and press Connect.
  4. Accept the folder. Within a minute Syncthing on your computer offers a folder. Accept it and choose where it goes on your disk.

If it does not connect

  • Wait a minute: devices do not find each other instantly.
  • If there is still no connection, open the server device's settings in Syncthing, the Advanced tab, and put the server address shown on the sync page into Addresses.
  • Check the status on the sync page: "In sync", "Syncing, N%", "Offline, last seen …" or "Waiting for the first connection".

Several devices

The same page lists Connected devices. You can connect another computer or disconnect an old one. Files already downloaded stay on a disconnected device.

Deleted files and the trash

Files deleted or overwritten during sync are kept for 30 days in Syncthing's trash (the .stversions folder). It is not shown in Eggent's file panel.

When the plan is inactive

If the trial or the plan has ended, sync keeps sending files to your computer but stops accepting changes from it. The sync page shows this. After payment it works both ways again.