How do gems, shards, and tabs fit together?

Q: How do gems, shards, and tabs fit together?

It’s two levels. Gems are the top level, one per project, and you switch between them from the crystal rail (the screen-edge dock) or the gem tab bar across the top of the window. Shards are the sessions inside a gem, shown in the shard bar that appears once a gem has two or more; each shard is its own terminal and can hold its own agent session. The gem tab bar can sit across the top by default, or down the left side with Sidebar Mode on (settings, general). Every gem always keeps at least one shard.

It’s two levels. Gems are the top level, one per project, and you switch between them from the crystal rail (the screen-edge dock) or the gem tab bar across the top of the window. Shards are the sessions inside a gem, shown in the shard bar that appears once a gem has two or more; each shard is its own terminal and can hold its own agent session. The gem tab bar can sit across the top by default, or down the left side with Sidebar Mode on (settings, general). Every gem always keeps at least one shard.