Multi-Project Workflows

If you work on multiple projects or a microservices architecture, The Terminal’s workspace model scales naturally.

Multiple Projects

Using Spaces

Create a Space for each project:

• Space 1: Frontend — terminal (Next.js dev server), browser (localhost:3000), file navigator
• Space 2: API — terminal (Flask/Express server), terminal (Gee-Code), file navigator
• Space 3: Shared — git panel, terminals for database and infrastructure

Switch between Spaces to focus on one project at a time.

Using Splits

For tightly coupled projects (a frontend and its API), keep both visible:

┌──────────────────┬──────────────────┐
│  Terminal         │  Terminal         │
│  (frontend dev   │  (API server)    │
│   server)        │                  │
├──────────────────┼──────────────────┤
│  Browser          │  Terminal         │
│  (localhost:3000)│  (Gee-Code)      │
└──────────────────┴──────────────────┘

Microservices

For microservice architectures, use a combination of Spaces and splits:

Space: Services

┌──────────┬──────────┬──────────┐
│ Service A │ Service B │ Service C │
│ (terminal)│ (terminal)│ (terminal)│
└──────────┴──────────┴──────────┘

Space: Debug

┌──────────────────┬──────────────────┐
│  Browser          │  Observability   │
│  (gateway URL)   │                  │
├──────────────────┴──────────────────┤
│  Terminal (Gee-Code)                │
└─────────────────────────────────────┘

File Navigator Across Projects

Each File Navigator panel can point to a different directory. Use multiple file navigators to browse different project roots simultaneously:

┌──────────┬──────────┬──────────────────┐
│ Files:    │ Files:    │                  │
│ frontend/│ backend/ │   Terminal       │
│          │          │                  │
└──────────┴──────────┴──────────────────┘

Git Across Repositories

The Git panel shows the repository for the active terminal’s working directory. Switch between terminals to see different repositories’ commit graphs.

For a consolidated view, use the Observability panel to monitor activity across all terminals.

Tips

• Name your panels — with multiple projects, naming makes it clear which terminal is for which service
• Use workspace presets — save your multi-project layout so you can restore it instantly
• Pin file navigators — disable directory sync on navigators that should stay fixed on a specific project

Next Steps

• Spaces — organize multi-project workflows
• Workspace Presets — save layouts