docs
Built for your next idea.

Quickstart

Connect your first project and give your coding tools a shared starting point.

Before you start

You’ll need a Mac running macOS 12 or later, an Orka account on your chosen service, and a local project folder. Orka works alongside Codex and Claude Code.

Connect a project

  1. 1

    Choose where your context lives

    Open Orka and choose Orka Cloud or connect to your own server. Sign in using a method offered by that service.

  2. 2

    Create or join your project

    Create a project for your work, or join one using an owner’s invitation. Choose the local folder that belongs to the project.

  3. 3

    Review your sharing choices

    Review each category before continuing. Choose automatic sharing for ongoing context or Only when asked for explicit snapshots. These preferences belong to this Mac.

  4. 4

    Connect your coding tools

    Enable Orka’s project hooks through your tool’s native trust controls. Use the integration guides for Codex or Claude Code, and add the MCP plugin when you need its tools.

Check your connection

Check that the correct project and folder appear in Orka. With the MCP integration connected, ask your assistant to retrieve relevant shared context and show its sources.

Try asking your assistant
Bring me up to speed on this Orka project.
Find the accepted decisions relevant to my task and cite their sources.

If context is missing, check your account, selected service, project membership, repository mapping, and sharing settings. A new project may have no accepted shared context yet.

Have a question or an idea? We’d love to hear it

On this page