Skip to content
Browse all documentation

Workspaces · 7 min read

Projects, workspaces, and tasks

Organize local repositories, optional isolated workspaces, and durable task histories.

On this page
  1. Projects map to local folders
  2. Use one task per outcome
  3. Optional isolated workspaces
  4. Source-control responsibility

Projects map to local folders

A project points to a directory on your machine. File tools, terminal commands, language services, change tracking, and Git status resolve from that directory.

Moving or deleting the folder outside Gyroscape can break the project link. Add it again if its path changes. Adding a project does not silently copy the whole repository into a hosted editor.

Use one task per outcome

Create a new task when the objective, branch, or acceptance criteria change materially. Reuse a task for follow-up work on the same outcome so its decisions and tool results stay connected.

Use a result-oriented title such as “Keep desktop sessions signed in” instead of “Fix bug.” Titles are searchable in the sidebar.

Optional isolated workspaces

When workspace isolation is enabled for a Git project, Gyroscape can use separate working directories so independent tasks do not edit the same checkout. Each workspace keeps its own path and source-control state.

Wait until a workspace is ready and check the active workspace before commands, review, or launching a development server.

Source-control responsibility

Gyroscape can inspect Git state, show diffs, and run requested source-control commands. You remain responsible for the branch, commit, push, and release destination. Review before committing and verify the remote before pushing.

Existing uncommitted work belongs to you. Mention it when it overlaps the task so unrelated edits are preserved.