Kimi / desktop workflow guide
Kimi Work: desktop setup and your first local-file task
Kimi Work is the Work mode of Kimi’s desktop app. It can read files in a folder you connect and save a new document beside them. This guide takes you from the official download to a small first project, with sample files you can inspect and a checklist for reviewing the result.
Our first run: Kimi Work turned three fictional files into a workshop plan and left the inputs unchanged. It also listed the folder through a command without showing an approval prompt. Below, we explain the permission settings and show exactly what happened.
By China AI Chat Team · One desktop task tested September 23, 2026; official sources checked September 30, 2026 · How we test. ChinaAI is independent of Moonshot AI.

What is Kimi Work, and when should you use it?
Use Work when a task depends on files already on your computer: turning a brief and a CSV into a plan, combining notes into a report, or organizing copies of a project folder. Kimi’s Work overview describes a desktop agent for knowledge workers. You describe the task in ordinary language; it uses tools to read, create or edit files.
Choose the product by where the work needs to happen:
| Your job | Start with | Why |
|---|---|---|
| Ask a question or create an online document | Kimi web | No local project folder is needed. See our Docs guide for that browser workflow. |
| Read several files already on your computer and save a result beside them | Kimi Work | Its desktop project links to a local folder; review its file and tool actions. |
| Change and test source code in a repository | Kimi Code | Its developer workflow is built around code edits, commands and diffs. |
Kimi’s product comparison explains these routes. Work also offers browser and desktop plugins, Swarm for parallel work, Goal mode for longer tasks, and a Dashboard. The official tutorial covers those options. Start with a small file task before adding them; the hands-on example here tests local files only.
Download Kimi Work and connect your first folder
Download the app from Kimi’s official download page and sign in with your Kimi account. Work requires Windows 10 or later, or an Apple-silicon Mac with macOS 12 or later, according to the requirements. The Intel Mac desktop download supports Chat only. Kimi’s mobile app is a separate route; this local-folder workflow runs on a supported computer.
Before you start, check that Work is available in your account and that you have credits to run a task. Our example used a Kimi account without a Platform API key. See free access and credits below. Work is still in beta, so your controls may differ from the recorded session.
- Prepare a small folder. For the example below, download the fictional workshop project (ZIP) and extract it. Create a new folder, such as
Workshop trial, then copy onlybrief.md,sessions.csvandconstraints.mdfrom the extractedinputsfolder into it. Leave the suppliedoutputfolder and test records outside your trial folder: they are reference material for comparison afterward. For your own task, start with non-sensitive copies you can restore. - Switch to Work and link that folder. In our recorded Windows session, the Work and Chat tabs were at the upper left. Under Projects, Add folder → Use existing folder linked the trial folder. Select the folder containing the three input files, rather than the whole extracted ZIP package. Work Projects and Chat Projects are separate and do not share data, as Kimi’s Projects help explains.
- Check the selected folder, model and permissions. Read the labels beside the composer before sending a task. The current tutorial recommends K3 High; our September 23 session used K2.8 Preview with High thinking effort. Choose the permission mode deliberately using the table below.
- Name the inputs and the output. Tell Kimi which files to read, what to create, what must stay unchanged and which uncertainties to flag. The exact example prompt below asks for one new file in the same folder.
A connected folder tells Kimi where to work; it does not establish a technical boundary that prevents every action outside it. Keep your first project separate from live client records, credentials and irreplaceable files.

Understand the permission setting before pressing Send
Kimi’s permission FAQ describes three modes:
| Mode | Kimi’s documented behavior | Practical implication |
|---|---|---|
| Manual approval | Asks before acting. | Use when you want to inspect proposed actions one by one. We did not test this mode. |
| Default | Routine operations run automatically; the FAQ says it prompts before sensitive local-file modifications, overwrites or code execution. | Our folder listing, reads and creation of a new file proceeded without a visible approval prompt. |
| Fully automatic | Acts without asking, including potentially harmful changes. | Avoid it for a first run or irreplaceable files. We did not enable or test it. |
The project folder and permission mode answer different questions: where should Kimi work, and when should it ask? Neither establishes offline processing. A prompt can guide an agent, but it cannot enforce an approval setting. Kimi’s FAQ warns that Fully automatic can alter or delete files and system configuration; our test does not establish how another version will classify an action.
Try one task with a result you can verify
For our test we created three fictional files for a community-library workshop: brief.md gave the event and audience, sessions.csv listed three sessions, and constraints.md contained venue needs and a disagreement about the second session’s start time. We froze the checks before sending the task: preserve the inputs, keep every row and number, show the time conflict, and invent no fee or registration link.
Here is the exact first prompt we sent in the linked project:
In this isolated fictional project, read only brief.md, sessions.csv and constraints.md. Create workshop-plan.md in this same folder for a coordinator to review. Include a table with all three sessions, their IDs, dates, draft times, topics, leads and capacities; then a short preparation checklist. Flag the conflicting W2 start times clearly and do not decide which is final. Preserve all names and numbers from the source files. Do not edit, move or delete the three input files. Do not install software, run code, browse the web, connect external services or schedule a task. Do not invent a fee, budget or registration link. Briefly report what you read, what you wrote and any tool or permission failure.
Open the saved file and check the work
The requested result is workshop-plan.md, a Markdown text document saved in your connected folder. Open it in a text editor or Markdown viewer; it is not a Word file.
- Compare the session table with
sessions.csv. Check all three IDs, dates, times, topics, leads and capacities. - Look for the unresolved W2 time conflict. The CSV says 10:30; the older email mentioned in
constraints.mdsays 11:00. The plan should show both and ask for confirmation. - Check the folder and action timeline. Confirm that the intended output was added, review any changes to the inputs, and inspect the tools and commands used. A plausible document does not tell you which actions produced it.
For your own task, use the same structure: name the source files, specify the deliverable, preserve the facts, flag uncertainty and state the actions that need approval. If shell commands are outside your task, say so explicitly. Then review the actual actions and compare the saved result with its sources.
Our result: accurate plan, plus a read-only shell command
The first run produced workshop-plan.md in the isolated folder. It included all three source rows: W1 Email safety, 09:00–10:00, Nora Bell, capacity 18; W2 Photo organization, 10:30–11:30, Leo Tran, capacity 16; and W3 Spreadsheet basics, 12:00–13:00, Mina Costa, capacity 14. Each retained the source date, October 10, 2026. The plan set the older-email 11:00 W2 start against the CSV’s 10:30 draft and asked the coordinator to confirm it. It did not quietly choose a final time.
The checklist kept the Room 2B booking and instructor confirmations, step-free access, projector and microphone. It invented no fee, budget or registration URL. After the run, we checked the saved file ourselves and compared SHA-256 hashes (file fingerprints): all three input files were byte-identical to their pre-run versions; the output was the only new file. Kimi’s final message also said no tool or permission failed.
The unexpected step: Kimi’s tool timeline showed one shell command, ls -la, to list the project folder. It was read-only. Our prompt said not to run code, which may be read as forbidding scripts rather than all shell commands; it did not explicitly say “do not run shell commands.” Kimi then used three file-read tools and one file-write tool. We saw no approval dialog in Default mode. If shell access is out of scope for your task, say so explicitly and inspect the actual tool actions. A final “Done” message alone is not enough.
Test conditions: September 23, 2026
Windows desktop app 3.2.9; signed-in Moderato account; Work mode; K2.8 Preview with High thinking effort; Default permissions; one prompt and one resulting file. The app offered an update to 3.2.12, which we did not install.
This was an existing installation. We did not test a fresh installer, macOS, other permission modes, sensitive files or data handling, and did not measure credit use. The task was not repeated to improve the result. The downloadable record retains the exact prompt, original output and before-and-after file fingerprints.
Download the fictional input files, first output, exact prompt and test record (ZIP). Use these to inspect the dates, conflict and unchanged inputs. One successful output and one unrequested shell command are evidence about this task in this setup, not a general reliability or security rating.
Is Kimi Work free, and do you need an API key?
Kimi says Work can be downloaded and run without a paid plan. Its official introduction says new users receive limited free credits for an initial trial. That is not unlimited free use: check the access, available features and credit balance shown in your own account.
Desktop sign-in uses a Kimi account. Our workshop task did not require a Kimi Platform API key. Work draws from the shared membership credit pool according to usage, as described in Kimi’s credit rules. Other features can use the same balance. Kimi Code additionally has its own 5-hour and weekly rate limits.
We did not measure the credits or dollar cost of this exercise. Check your balance before a long task; the Kimi pricing guide explains plans, shared credits and the separate API billing route.
Questions to settle before using real files
| Question | Useful answer |
|---|---|
| Will the app ask before writing a new file? | Do not assume it will in Default mode. Our test created a new file without a visible prompt. Review Kimi’s permission modes and use Manual approval when you want to inspect actions first. |
| Are my files kept entirely offline? | A local project means the app works with files on your computer; it does not establish offline model processing. Check the provider’s current privacy information before using confidential material. |
| Can I continue a Work project on another device? | Kimi’s download FAQ says Chat conversations sync across devices, but Work conversations stay on the desktop where they were created. Continue a local-file task on the computer that holds those files. |
| My screen or model differs from this guide. | Use the current official tutorial and read the version, model, project and permission labels shown in your own app. |
If your goal is to program inside a repository, continue to our Kimi Code guide. If you want to work with an uploaded browser document instead, start with Kimi Docs or Kimi Sheets.
Official product, setup, platform, permission and billing sources checked September 30, 2026. The hands-on result is from September 23, 2026. Methodology · Report a correction.
