Skip to main content
A Space is the top-level boundary for work in Eigent. It groups projects, tasks, triggers, and files so that related work stays together.

​
Choose a Space type

​
Blank Space

A blank Space starts with an Eigent-managed scratch workspace. Use it for research, writing, planning, or tasks that should not modify an existing local folder.

​
Local-folder Space

A local-folder Space binds Eigent to a folder on your computer. Use it when agents need to inspect or modify an existing codebase, document set, or project directory.

​
Legacy Space

A legacy Space contains work created before the current Space system. Eigent keeps these projects available so that older task history remains accessible.

​
Create a blank Space

  1. In the Home dashboard, select Spaces.
  2. Open the create menu.
  3. Select Start from scratch.
  4. Eigent creates a Space and opens its Workspace.
  5. Optional: Rename the Space from the Space switcher.
Blank Spaces use artifact-only storage. Agents create outputs in Eigent-managed project storage rather than writing directly to a user-selected folder.

​
Create a Space from a local folder

  1. In the Home dashboard, select Spaces.
  2. Open the create menu.
  3. Select Use local folder.
  4. In the folder picker, select the directory that Eigent can access.
  5. Confirm the selection.
The Space name initially follows the selected folder name. The Context tab shows the folder binding.
Screenshot placeholder: Add a screenshot of the Space creation menu with Start from scratch and Use local folder visible.

​
Switch Spaces

  1. In the project sidebar, select the current Space name.
  2. Select another Space.
Eigent loads that Space’s projects and restores its most recently visited project when possible.

​
Rename a Space

  1. Open the Space switcher.
  2. Open the actions for the active Space.
  3. Select Rename.
  4. Enter a non-empty name and select Save.
Legacy Spaces and some system-managed Spaces cannot be renamed.

​
Work with local changes

Local-folder Spaces can show pending workspace changes. Depending on the current state, the Space menu can provide actions to:
  • Load or refresh the working directory.
  • Apply pending changes.
  • Discard pending changes.
  • Resolve a stale workspace state.
Review changed files before applying or discarding them.
Video placeholder: Add a short MP4 showing a local-folder Space, agent-generated file changes, review in Context, and the apply or discard workflow. Include captions.

​
Review Space status

The Spaces dashboard shows:
  • Space name and source type
  • Local folder name when applicable
  • Project count
  • Task count
  • Trigger count
  • Current operational status
Use board view to group Spaces by default, running, and awaiting-review state.

​
Troubleshooting

​
Context is unavailable

The active Space might not have a workspace binding. Create a Space from a local folder or wait for Eigent to finish preparing the scratch workspace.

​
A local folder does not appear

Confirm that the folder still exists and that Eigent has operating-system permission to access it.

​
A blank Space disappeared

Eigent can hide unused placeholder Spaces. Start a project or give the Space a meaningful name to keep it in the dashboard.