Skip to content

Projects

Ra1nify edited this page Oct 31, 2026 · 1 revision

Projects

A project is one memory store. A project can be bound to several instances; each instance mounts the project directory as a junction.

List columns

Column Meaning
Name Project name
Path Local code workspace
Conversations Number of conversations in the memory store
Status Running (held by an instance) / Idle
Owning instance Running instance holding the project

A missing path shows Invalid path. Use Relocate to fix it.

Toolbar

Button Behavior
Import from .gemini Pick a directory, scan historical projects and conversations under .gemini, write them into the registry and memory store
Refresh Re-reads project state

Row actions

Button Behavior
Conversations Opens the conversation preview dialog
Actions Menu: rename, fork, export Markdown, delete
Relocate Reassign the local code workspace

Memory store layout

projects\{id}\memory\
  brain\{conversationId}\              Conversation context
  conversations\{conversationId}.db    Conversation database
  conversation_summaries.db            Summary index

Actions menu

Item Behavior Constraint
Rename Changes the project name —
Fork Deep-copies the memory store into a new project; the name must be unique Fails when the target name exists
Export Markdown Exports a conversation to .md —
Delete Removes the definition and memory store; local sources are kept Unavailable while running

Fork copies databases through the SQLite online backup API rather than copying files, so uncommitted WAL content is included.

Binding and sharing

Bound projects Mount New conversation lands in
1 Whole-directory junctions The project
≥2 Instance directories plus per-conversation junctions The instance sandbox; written back when the process exits

Write-back condition: the conversation workspace_uris contains the project path.

Mutex

One project is usable by one running instance at a time. State lives in data/projects.json:

Field Meaning
RunningInstanceId Owning instance ID
ProcessId Owning process PID
IsRunning Running flag

A crashed instance leaves the flags behind. The next launch detects the conflict and offers forced takeover.

Import

Import from .gemini scans:

  1. every conversation directory under the chosen .gemini\antigravity\brain\;
  2. .gemini\antigravity\conversations\*.db;
  3. .gemini\antigravity\conversation_summaries.db.

Conversations are grouped into projects by workspace_uris. Existing conversations are skipped, not overwritten.

Related files

File Role
data/projects.json Registry and mutex state
data/projects/{id}/memory/ Memory store
src/Gravityless.Core/Services/ProjectService.cs Import, fork, rename, delete
src/Gravityless.App/Resources/Languages/*.xaml Text keys Projects_*

Clone this wiki locally