Projects & repositories
Keep related work together, even when it lives in more than one repository.
Your project is the shared home
An Orka project brings together members, repository sources, and shared resources. Your local folder is your Mac’s connection to that project. Teammates can connect their own checkouts without using the same filesystem path.
Create a project from your folder or join an existing project through an invitation. Verify the service and project before connecting, especially if you use both Orka Cloud and a self-hosted server.
Connect multiple repositories
- 1
Choose the existing project
Group related repositories under the same Orka project rather than creating an unrelated project for each checkout.
- 2
Map each local folder
Connect each repository to its corresponding source. When a match is ambiguous, choose the repository explicitly.
- 3
Use repository scope
Filter context to the relevant repository. MCP tools accept source identifiers so instructions and resources stay scoped to the work.
Shared and personal names
In Settings → General, an owner can change the shared project name when the service supports renaming. A member can save a personal name that stays on their Mac, or choose Use shared name to follow the owner’s name again.
Have a question or an idea? We’d love to hear it