Install Kora
Install the app in Applications and clear the first-launch Gatekeeper warning.
Kora
Kora is the workspace where context becomes action. Use this manual while working in Kora Desktop: create projects and sessions, connect model providers, work with files, run tools, use the editor and terminal, and configure integrations.
Kora Desktop is free and works without an account when you connect your own providers. Add Kora Premium when you want Flash, Remote Pairing, encrypted Cloud Sync, Telegram, and the other features marked Premium.
Get startedSet up Kora
Section titled “Set up Kora”Complete the first launch
Connect a model, create a project, take the tour, and open the first session.
Configure a provider
Connect a built-in or custom provider and select a model.
Find your way around
Locate projects, sessions, chat controls, panels, and Settings.
Work in the app
Section titled “Work in the app”Manage sessions
Create, switch, rename, close, reorder, and search sessions.
Run multi-step tasks
Choose an execution mode and control a task while it runs.
Follow background subagents
Watch the parallel workers Kora spawns and open their live output.
Use Goal Mode
Keep one session working toward a completion condition with bounded autonomous evaluation.
Work with files
Open files, add them to chat, and review proposed edits.
Focus the editor
Give an open file more space while keeping its project available.
Mention project context
Add files, folders, and skills to a message, then open them from replies.
Navigate long sessions
Move between turns and follow a running task.
Inspect a Git repository
Stage and commit work, manage branches, and synchronize a local repository.
Connect an SSH folder
Add a remote folder to a project and work on its files.
Connect an MCP server
Configure a local or remote server and make its tools available in chat.
Use skills
Load a skill from disk and invoke it from the chat composer.
Control Kora from your phone
Scan a QR code and run the active session from your phone’s browser.
Configure Telegram
Receive task notifications and reply from your phone.
Configure Cloud Sync
Synchronize sessions and settings between Kora installations.