Install Kora
Install the app in Applications and clear the first-launch Gatekeeper warning.
Use this manual while working in Kora Desktop. It covers the actions available in the app: 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 does not require a Kora account. Connect your own providers, or add a Kora Cloud key when you want to use Flash and the app features marked Premium.
Get startedInstall Kora
Install the app in Applications and clear the first-launch Gatekeeper warning.
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.
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.
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.
Use an adaptive layout
Keep the composer usable in a narrow workspace.
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.
Configure Telegram
Receive task notifications and reply from your phone.
Configure Cloud Sync
Synchronize sessions and settings between Kora installations.