Farside

Farside 0.3.1

A desktop agent client for Kimi Code.

Download for Windows

About Farside

Farside is a desktop agent client for Kimi Code, built with Electron, React, and TypeScript. Farside does not present coding tasks as ordinary chat: the moon phase represents the agent state (new moon = idle, waxing crescent = thinking, waxing gibbous = executing, full moon = awaiting approval, waning crescent = wrapping up), and sessions are orbital timelines of transmissions (thinking), instruments (tools), satellites (subagents), and ground (user instructions). It supports project and session management (pin, archive, fork, export), multimodal and file context, tool approval and structured questions, a ⌘K command palette aligned with the Kimi Code CLI, a real terminal, live file tree with Git status and diffs, a built-in preview pane (Markdown / HTML / SVG / images), multiple account options (Kimi OAuth, the official Moonshot API, and OpenAI-format third-party Kimi services), membership usage display, and MCP, Skills, and Plugins management. The default interface is Chinese with a dark theme; English and light mode are one click away.

What's new in 0.3.1

Farside 0.3.1 · 崩溃兜底、审批提醒与发布链补全
本版本集中解决"静默失败"：界面与进程崩溃不再无声白屏，Agent 等待审批时会主动把用户叫回来，排队指令在异常退出后可恢复；Linux 首次进入正式发布渠道。建议所有用户升级。
升级亮点
- 界面崩溃不再白屏：此前任一组件抛错会卸载整棵 React 树，只能重启应用。现在轨迹区域出现畸形事件时只损失自己那块视图（可点"继续"恢复）；整窗级异常提供双语降级卡片与一键重载。主进程未捕获异常会记录并弹窗提示，渲染进程崩溃在短窗口内自动重载，反复崩溃才升级为人工处理提示。
- 审批等待会"叫你回来"：此前切到别的应用后，等待批准的工具调用不会有任何窗口外提醒，Agent 可能无限期挂起。现在窗口不在前台时发送系统通知（点击直接回到窗口）、闪烁任务栏并显示 dock 角标计数；回到窗口自动清除。系统通知按 1 秒合并，不会刷屏。
- 跨会话审批可见：此前审批卡只渲染当前会话的队列，B 会话的审批在 A 会话里无处可寻。现在标题栏出现"满月 · N 待处理"徽标，一键跳转到等待确认的会话；设置页/目标页停留期间的待处理项同样计入。
- 断线全局可见：此前连接状态埋在遥测面板里。现在标题栏在链路中断时显示"链路中断 · 重连中"红点指示。
- 排队指令不再丢：崩溃或误退后重新打开 Farside，排队未发送的指令自动恢复到队列（附件二进制不落盘，纯附件条目会丢弃并保留文本）。
- Linux 正式交付：AppImage 随 Release 发布并支持应用内更新；所有安装包附带 SHA256SUMS.txt 供校验。
- 长会话更流畅：轨迹分组改为 Turn 级复用，流式输出期间已完成的轮次不再重渲染；Markdown 解析与渲染 memo 化；隐藏的 Mission Panel tab 不再空转 git_status 轮询。
新增与改进
可达性
- 命令面板（⌘K）：role="dialog"/aria-modal 语义、Tab 焦点圈定、listbox/aria-selected、输入法组词期 Enter 不再误执行命令。
- Provider 引导层：Esc 可跳过、对话框语义与初始焦点。
- 提问卡：单题支持数字键直接选择，选项带选中态语义，与审批卡键盘体验对齐。
- 设置页：Esc 返回会话视图（配置编辑器有未保存改动时不劫持）。
- 次要文本对比度全部校准到 WCAG AA（≥4.5:1）：环境摘要中的 git 错误提示此前以约 1.8:1 显示、几乎不可见，现已修复。
- 尊重系统"减弱动态效果"：JS 平滑滚动与 CSS scroll-behavior 一并降级。
桌面体验
- 窗口位置与尺寸持久化（含最大化状态）；启动时按显示器工作区钳制，拔掉副屏后窗口不再落在屏幕外。
- 面板宽度保护：会话栏与 Mission Panel 同时拖宽时，主内容区保底 340px，不再被压成零宽死局；窗口缩小时面板自动收窄。
- 应用内更新下载增加 60 秒停滞看门狗，弱网下不再无限挂起，失败自动清理半截安装包。
问题修复
- 修复登出后个人画像仍显示旧账户用户名的问题（OAuth 身份缓存未随登出清理）。
- 修复中文输入法组词期间按 Shift+Tab 误触计划模式、命令面板 Enter 误执行的问题。
- 修复设置页一次 Esc 既中断运行中任务又返回会话的双重动作冲突。
- 修复思考计时器以 10fps 无谓重渲染的问题（展示精度不变）。
Runtime 与兼容性
- 唯一 current Runtime 保持 Kimi Code 0.39.1，无协议变化，无本地数据迁移。
- 新增 IPC 通道 app:notify-attention（审批/提问注意力引导），其余契约不变。
下载与安装
- Windows：.exe
- macOS Apple Silicon：.dmg
- Linux：.AppImage（新增）
- 全部安装包的 SHA-256 见 Release 附件 SHA256SUMS.txt。
升级前请结束正在执行的 Agent 任务。安装包不会主动删除本地项目、Kimi 配置或会话数据。
发布验证
- 72/72 自动化测试通过（新增轨迹分组、composer 会话态、prompt 队列、斜杠命令注册表四组渲染层纯逻辑测试）；TypeScript 类型检查与生产构建通过。
- GitHub Actions 负责 Windows / macOS / Linux 安装包构建和发布。
已知限制
- macOS 安装包仍未签名与公证，首次打开需在系统设置中放行；签名与公证列入后续版本。
- 无 node-pty 的环境仍使用管道降级后端：无窗口尺寸同步能力，终端体验为降级形态。
完整变更
https://github.com/dandandujie/Farside/compare/v0.3.0...v0.3.1

Full release notes »

Technical details

Publisherdandandujie
Version0.3.1
Release date2026-09-06
LicenseMIT
Installer typenullsoft
Architecturex64
Package IDdandandujie.Farside
Install scopeCurrent user

Install Farside from the command line

Install with Windows Package Manager
winget install --id=dandandujie.Farside -e
Update to the latest version
winget upgrade --id=dandandujie.Farside -e
Uninstall
winget uninstall --id=dandandujie.Farside -e
Silent install with the offline installer
"Farside.Setup.0.3.1.exe" /S /currentuser

Silent install switches for more Windows programs »

Install Farside together with other apps in one command »

agentagenticaichatbotcodecodingkimikimi-codelarge-language-modelllmprogramming

Farside version history

0.3.0 Sep 5, 2026

Farside 0.3.0 · Kimi Code 0.39.1 适配与桌面体验升级
本版本将唯一 Runtime 从 Kimi Code 0.31.1 升级到 0.39.1，并集中修复了首次配置门禁、终端、回退与关闭流程中的一批交互缺陷，建议所有用户升级。
升级亮点
- 首次配置不再强制：Provider 引导层可以"暂不配置，直接进入"；服务端故障不再被误判为未配置；未配置状态下历史会话照常展示，可随时从空状态页或设置完成接入。
- 终端按工作区缓存：切换会话/项目只切换终端显示，正在运行的 shell 任务（dev server、安装等）不再被杀掉；最多缓存 8 个实例，按最近使用淘汰。
- 修复打包版终端 Enter 无效的问题：随包 runtime 始终使用管道降级后端，而管道没有 tty 的 CR→NL 行规转换，导致按 Enter 毫无响应；现已规整输入并让 zsh 以交互态运行（有提示符、有回显）。
- 回退操作更安全：撤销上一轮改为先回退会话、再回滚文件，失败时自动重试并如实报告，不再出现"文件已回滚、轨迹还在"的不可逆半完成状态。
- 关闭保护覆盖原生路径：macOS 红绿灯等原生关闭在任务运行中会弹出确认；标题栏 ×、/exit 与 Windows 更新退出流程行为保持不变。
- 斜杠命令治理：补全清单只保留桌面端真实实现的命令；/login、/provider、/plugins、/mcp-config、/theme、/logout 映射到对应设置分区或真实动作；未实现命令给出明确提示，不再被静默当作提示词发送；/model 校验模型 ID。
- 补齐约 60 条英文界面文案，文件选择竞态、侧栏初始宽度、燃料环刻度、配置编辑器草稿保护、OAuth 轮询容错等小缺陷一并修复。
Runtime 与兼容性
- 唯一 current Runtime：Kimi Code 0.39.1。
- 固定上游 revision 5efca0c3116743855c28426000073bfe34a4862f。
- 锁定 Windows、macOS、Linux 的 x64/arm64 六平台官方产物及 SHA-256。
- /api/v1 REST、/api/v1/ws（协议版本仍为 2）、实例注册、shutdown 生命周期与会话持久化布局全部增量兼容，无需迁移本地数据。
- 两处协议修复替换了 0.31 上从未开放（404）的 /api/v2 RPC：插件管理迁移到官方 REST（POST /api/v1/plugins 等，此前插件安装/启停实际不可用）；删除无效的配置 reload 调用（0.39 原生监听 config.toml 热加载）。
- 适配 0.39 的 /api/v1/auth 摘要变化（ready 字段移除），按上游语义重推就绪状态，已对真实 0.39.1 实例完成端到端验证。
下载与安装
- Windows：.exe
- macOS Apple Silicon：.dmg
升级前请结束正在执行的 Agent 任务。安装包不会主动删除本地项目、Kimi 配置或会话数据。
发布验证
- 30/30 自动化测试通过；TypeScript 类型检查与生产构建通过。
- Kimi Code 0.39.1 正式产物下载、SHA-256 校验及 Server meta/WebSocket smoke 通过。
- 插件 REST、配置热加载、auth 就绪推导在真实 0.39.1 实例上定向验证通过。 …

0.2.3 Aug 5, 2026

本版本将唯一 Runtime 从 Kimi Code 0.29.2 升级到 0.31.1，保持现有桌面交互、会话数据和服务生命周期兼容，建议所有用户升级。
升级亮点
- 跟进 Kimi Code 0.30–0.31.1 的自定义 Agent、插件 system prompt、secondary model 和非阻塞 TaskOutput 等 Runtime 能力。
- 保持现有 /api/v1 REST、/api/v1/ws、实例发现和 shutdown 生命周期兼容，无需迁移本地配置或历史会话。
- 修复空 Runtime 补丁队列被误判为冲突的问题；上游已经吸收的历史补丁不再重复应用。
- 更新存在安全公告的间接依赖，依赖审计结果为 0 漏洞。
Runtime 与兼容性
- 唯一 current Runtime：Kimi Code 0.31.1。
- 固定上游 revision 6b56c11697771fe596099b38bafae539820309a4。
- 锁定 Windows、macOS、Linux 的 x64/arm64 六平台官方产物及 SHA-256。
- 已审查 REST、WebSocket、wire、session、profile、tool、auth、配置、UI/IPC、持久化与构建变化，未发现需要用户迁移的破坏性变更。

Frequently asked questions

Is Farside free?

Yes. Farside is free and open-source software released under the MIT license.

What is the latest version of Farside?

The latest version is 0.3.1, released on Sep 6, 2026.

Is it safe to download Farside?

The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 9a69669f64663c97cedb8a7ee4166392b92b24f6f3ffea58aa30ea4a0716fbfe.

Which Windows versions does Farside support?

Farside runs on Windows and is available for 64-bit (x64) systems.

How do I install Farside silently?

Run the offline installer with "Farside.Setup.0.3.1.exe" /S /currentuser, or install it with Windows Package Manager: winget install --id=dandandujie.Farside -e --silent.

How do I uninstall Farside?

Open Settings › Apps › Installed apps, find Farside and select Uninstall. From the command line, run winget uninstall --id=dandandujie.Farside -e.

Alternatives to Farside

Other AI for Productivity programs for Windows from different developers.

More from dandandujie