eigent/docs/projects/overview.md
Tong Chen 97d7554438
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Pre-commit / pre-commit (push) Has been cancelled
Test / Run Web + Local Brain Smoke (push) Has been cancelled
Test / Run Frontend Guardrails (push) Has been cancelled
Test / Run Python Tests (push) Has been cancelled
release: Eigent 1.0.0 (#1695)
Co-authored-by: Douglas <douglas.ym.lai@gmail.com>
Co-authored-by: Douglas Lai <115660088+Douglasymlai@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Tao Sun <168447269+fengju0213@users.noreply.github.com>
Co-authored-by: Weijie Bai <happy.regina.bai@gmail.com>
2026-06-17 00:29:35 +08:00

3.2 KiB

title description icon
Projects overview Understand how Spaces, Projects, Sessions, and Runs organize work in Eigent. folder-kanban

Projects are persistent workstreams inside a Space. A project keeps related conversations, task runs, agents, files, browser activity, terminal state, and automations together.

Product hierarchy

Eigent organizes work into four levels:

Level Purpose
Space Defines the top-level workspace and file boundary
Project Groups related work around an ongoing goal
Session Presents the conversation and execution surfaces
Run Represents one request or follow-up task

For example, a Space called “Marketing” can contain a “Product launch” project. The project session can include separate runs for research, copywriting, and presentation creation.

Use the project sidebar

The project sidebar is available in the main Workspace. It provides access to:

  • The Space switcher
  • Workspace
  • Context
  • Scheduled triggers
  • Dispatch
  • New project
  • Projects in the active Space
  • Project actions

The sidebar can be resized or folded into an icon rail.

Screenshot placeholder: Add a screenshot of the expanded project sidebar. Annotate the Space switcher, Workspace, Context, Scheduled, Dispatch, New, and project list in surrounding text.

Start a project

  1. Select a Space from the sidebar.
  2. Select New or open the Workspace.
  3. Enter the first task.
  4. Choose Single Agent or Workforce mode.
  5. Attach required files.
  6. Send the task.

Eigent creates the Project and opens its live Session.

Continue a project

Submit a follow-up request in the same conversation. Eigent adds a new Run while preserving earlier prompts, progress, and outputs.

Use this approach when the new request contributes to the same goal. Create another Project when the work needs a separate history, file context, or lifecycle.

Manage project status

Active

An active project can accept new runs, execute triggers, and appear in the project sidebar.

Achieved

An achieved project is complete. If a run is still active when you end the project, Eigent stops that run before saving the achieved state.

Archived or deleted

Archived projects leave the active workflow. Deleting a project can also remove its local project data. Save important output files before deletion.

Search across projects

Use Command/Ctrl + K from the Workspace to open global search. Search can help locate existing projects and sessions without returning to the Home dashboard.

Video placeholder: Add a 60-second MP4 showing project creation, a follow-up run, global search, and project completion. Include captions.

Start the first run and choose an execution mode. Follow agent execution and review outputs. Continue work with follow-up requests.