Step 7 of 14

Agent Deck

Agent Deck is your command center. Every tool you use — Claude Code, Nexus, GSD — launches from here. You never need to type raw terminal commands. Just navigate, select, and go.

What is Agent Deck?

Think of Agent Deck like the home screen on your phone. You tap an app to open it — you don't type commands. Agent Deck works the same way: you see your groups on the left, your sessions on the right. Select one and the right tool opens in the right folder.

Groups and Sessions

Agent Deck organizes your work into groups (categories) and sessions (workspaces). Two groups are already set up for you:

How to Navigate

1. Agent Deck shows groups on the left. Use ↑ ↓ arrow keys to move between them.
2. Press Enter to select a group. The sessions appear on the right.
3. Use ↑ ↓ to pick a session, then press Enter to open it.
4. You're now inside that session — Claude Code, Nexus, or whatever tool is configured.

Creating a New Group

Groups organize your sessions by project or topic. To create one:

1. From the Agent Deck home screen, press G.
2. A popup appears — type the group name (for example Mining or Research).
3. Press Enter to confirm. The new group appears in the list.

Creating a New Session

Every new project needs its own session. This is how you start new work:

1. Navigate to the group where you want the new session.
2. Press N to create a new session.
3. Type the session name (use the project name, like subnet-42).
4. Set the path — this is where the project files will live (like /home/giorgia/subnet-42). If the folder doesn't exist, Agent Deck creates it automatically.
5. Select the tool — choose claude for Claude Code projects or nexus for Nexus Intelligence. Only use these two.
6. Press Enter to confirm. The new session appears in the group.

Auto-Copy

When you select (highlight) any text inside Agent Deck, you'll see it turn yellow. This means it's automatically copied to your clipboard. You can paste it anywhere with Cmd+V on your Mac.

Keyboard Shortcuts