13. Workspace

Starting with Naia Shell 0.1.7, the Herdr work surface is integrated into Workspace. You can find workspaces and AI agents inside Naia and move directly to the terminal that owns the selected work.

This release is Windows-first. It provides the foundation for viewing and controlling a Herdr workspace inside Naia. Linux (Naia OS) and macOS validation are planned for the next version, together with one-click handoff from a terminal or result file to the Workspace viewer and full three-layer orchestration.

1. Open Workspace

1. On a Windows PC, update Naia Shell to version 0.1.7 or later.
2. Select Workspace from the app menu.
3. Wait for the Herdr terminal to appear in the work surface on the right.
4. If Starting Herdr… does not finish, or Herdr reports that it exited, select Retry.

The right-side ModeBar and Claude Code session cards described in the old manual are no longer the current layout.

2. Understand the left navigation

The left navigation is arranged in this order:

Switch workspaces

1. Open Spaces.
2. Select the workspace you want to inspect.
3. Confirm that the Herdr surface on the right follows that workspace.
4. Open File Tree and confirm that its root changed with the workspace.

Inspect an agent

1. Open Agents.
2. Select the agent you want to inspect.
3. Confirm that the owning workspace, tab, and terminal are focused on the right.
4. If the agent is waiting for a question or approval, read the terminal and make the decision yourself.

3. Work in the Herdr terminal

The right-hand surface is the Herdr work surface, not a separate terminal imitation. It continues to use the tabs and terminals in the existing Herdr session.

• Enter commands and inspect output.
• Move between work by selecting Spaces or Agents.
• Return from another screen and continue using the existing Herdr terminal.
• Version 0.1.7 forces a redraw when the terminal is reattached or reactivated, addressing the blank terminal surface seen in earlier builds.

4. Inspect work on another Bazzite PC

Workspace in Naia Shell 0.1.7 controls Herdr on the PC where Naia is running. Selecting and controlling another Bazzite PC directly from the Naia UI is not available yet.

For now, connect to Bazzite over SSH from the operator PC and use the official Herdr commands:

ssh bazzite-ai
HERDR_SESSION=agents herdr agent list
herdr agent attach <agent-name>

Replace bazzite-ai with the remote host alias from your SSH configuration. Replace <agent-name> with a name shown by herdr agent list. This path lets you check whether the Herdr job is still alive even when Moonlight or Discord is unavailable.

5. Current capabilities and next version

Available in the 0.1.7 Windows release

• View the Herdr work surface inside Naia Workspace
• Move between File Tree, Spaces, and Agents
• Follow the selected Space when choosing the File Tree root
• Focus the owning Herdr terminal by selecting an agent
• Redraw the terminal after reattachment or reactivation

Planned for the next version

• Validate Workspace on Linux (Naia OS)
• Validate Workspace on macOS
• Click a file in a terminal or work result and open it directly in the Workspace viewer
• Connect the three orchestration layers: Naia and naia-agent for user intent and approval, a Herdr issue leader, and bounded worker agents
• Select and control multiple remote PCs through one Naia interface

Internal connection code with automated tests is not the same as a completed user-facing feature. Do not assume that the next-version items above work in the current release.

6. Troubleshooting