Installation
Get the x64 Setup for Windows or universal DMG for macOS from the download page, then follow the standard installation flow for your system.
Resources / Documentation
The LukAi guide, from one prompt to a completed change.
Installation, working modes, tool permissions, model selection, project indexing, Remote SSH, account management, and troubleshooting in one place.
This guide reflects LukAi desktop 2.1.2 and the current LukAi Mobile experience.
Getting started
Download LukAi, connect your account through device sign-in, and open your first workspace.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableDevice sign-in
LukAi creates a short device code. Sign in on the browser device page and approve it; your account password is not passed to the desktop application.
First workspace
Open a local folder, multi-folder workspace, or Remote SSH target. Explorer, terminal, Git, and debugging retain standard IDE behavior.
Updates
Check for updates from the account center. The interface shows Downloading while retrieving a package and Applying during installation.
Agent workflows
Learn when and how to use Build, Plan, and Spec workflows.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableBuild
Describe a task in natural language. The agent can read, search, and edit project files, run terminal commands and tests, and show tool steps live in the conversation.
Plan
LukAi studies the workspace before writing code and produces an actionable plan. Apply plan adds a visible user command, switches to Build, and begins implementation.
Spec
Substantial work is separated into requirements.md, design.md, and tasks.md. Each document is approved separately before implementation starts in the same conversation.
Interactive questions
For an important ambiguity, the agent can ask one to three questions. Choose an option or enter a short answer and continue the same task without losing context.
Conversation and context
Attach file and code context, manage the message queue, and understand compaction in long conversations.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableAdd context
Use Ctrl/Cmd+L to attach the open file or selected code. Files, folders, code selections, and images remain removable context items until the message is sent.
Previous conversations
Return to recent threads from the searchable header selector, open a new conversation, duplicate the current thread, or delete it. The selector stays hidden before a real message exists.
Queue and Send now
While the agent works, Add to queue prepares the next turn without interrupting the response. Send now stops the active response and starts the new message. Invalid choices are hidden.
Long conversations and /compact
LukAi automatically summarizes older working context while preserving the complete transcript, checkpoints, and file history. Run /compact manually with an optional focus when needed.
Models and reasoning
Model selection, premium indicators, quotas, capacity, usage multipliers, and effort levels.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableCurrent catalog
The model list comes from the gateway. Account, group, quota, and provider capacity can change which models are selectable.
Premium and quota
Premium models receive animated text treatment. Quota policy, exhausted state, and full-capacity information appear on the selection row.
Usage multiplier
Each model's credit multiplier is visible in the list. Because policy can change it, one credit is not treated as one fixed request.
Effort and feature models
Choose minimal, low, medium, high, or very high effort. Chat, Quick Edit, Autocomplete, Apply, and SCM can share a model or use separate assignments.
Code intelligence
Configure the codebase index, semantic search, Quick Edit, and inline completion.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableSemantic index
After sign-in, the project is indexed in the background. File changes update incrementally instead of triggering a full scan, and generated or dependency folders are excluded.
Search and health
The agent can use file paths, the project tree, text or regex search, and semantic search. Settings show index state, chunk count, and partial or failed status.
Reindexing
Repeated full-index requests are coalesced and automatic retries have a five-minute cooldown. Normal incremental updates continue during that period.
Quick Edit and Autocomplete
Ctrl/Cmd+K applies a targeted edit to selected code. Optional FIM inline completion can be enabled in settings and assigned a separate model.
Approvals and revert
Separate tool permissions, review diffs, and safely revert completed agent changes.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableTool permissions
File edits, terminal commands, and MCP tools have separate automatic approval controls. With automatic approval off, the agent waits for an explicit accept or reject decision.
Diff review
Inspect changed files and lines in a live diff, then accept or reject one file or all changes together.
Checkpoint
A bounded checkpoint and changed-file summary are retained for a completed agent turn. Incomplete or unsafe-to-match turns are not presented as reversible.
Conflict-aware revert
If a file changed again after the agent turn, LukAi does not silently overwrite it. Conflict checks determine whether a safe revert is possible.
Terminal and web tools
Manage commands, long-running processes, and browser-based verification.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableOne-off commands
The agent runs a command in the terminal and reads its exit code and output. When terminal approval is enabled, it shows the operation summary first.
Long-running processes
Start a development server or watcher in a separate terminal, send additional input, and stop it when the task is complete.
Web content
Fetch the text of a URL or open it in the system browser. Network-dependent steps remain visible in the tool flow.
Browser verification
Collect HTTP status, redirects, console and page errors, failed requests, and screenshot results.
MCP and Skills
Connect external tools through MCP and import reusable Skills packages.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableMCP servers
List and use tools from configured MCP servers during a task, with an approval policy separate from files and terminal commands.
MCP configuration
Open the MCP configuration from LukAi settings, enable or disable a server, and inspect the available tools.
Skills
View, create, edit, disable, or delete Agentskills.io-compatible packages. The agent loads relevant skill content during a task.
Import
Import a Skill package from a GitHub repository or local folder, and review its source and permissions before use.
Remote SSH
Use desktop SSH profiles to develop a project on a remote server in a LukAi window.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableSSH profiles
Manage profiles from ~/.ssh/config or a selected custom config file through SSH Targets in Remote Explorer.
Connection mode
Open a target in a new or existing window and return quickly to previously used remote folders.
Authentication
SSH keys, ssh-agent, passwords, ProxyJump, and OpenSSH settings are used on the desktop. Private keys and config bodies are not sent to the gateway.
Remote platform
Select Linux, macOS, or Windows as the SSH target platform. Files, terminal operations, and the agent run against the remote workspace.
Account, updates, and support
Review usage, take over between computers, update the application, and generate a diagnostic code.
The behaviors below are directly visible in LukAi desktop 2.1.2.
StableAccount center
Plan, period credits, reset date, token information, updates, and support actions appear in one focused surface.
One active computer
Use multiple windows on one computer. To move to another computer, explicitly take over the session; active agent work on the previous computer is stopped.
Minimum version
The gateway can require a minimum client version for security or compatibility. An older client cannot send model requests until it is updated.
Diagnostics
Run LukAi: Send Diagnostic Information (Support) from the Command Palette. It creates a shareable DX code; including the active conversation requires separate approval by default.
Mobile companion
Review how to control an open desktop IDE and Remote Agent workflows from your phone.
The behaviors below are directly visible in LukAi desktop 2.1.2.
ReadyDiscover an open IDE
See online desktop IDE and workspace sessions for the same account. The mobile application does not compile desktop files by itself.
Agent control
Remotely manage conversations, models, Build/Plan, Spec, queueing, stopping, tool approvals, clarification answers, and safe revert.
Mobile Remote SSH bridge
See saved desktop SSH profile names and ask LukAi to open the selected profile in a new Remote SSH window. SSH secrets remain on the desktop.
Mobile access
Push notifications and diff review are active. LukAi Mobile is currently available to a limited number of users. The mobile application is not a full code editor.
LukAi 2.1.2
Move from the guide into the workspace.
Download the current desktop package and complete your first device sign-in.