gitwtfhub

wtf is kun?

kunagent/kun — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2026-07-03

5,032TypeScriptAudience · pm founderComplexity · 3/5ActiveLicenseSetup · moderate

TL;DR

A cross-platform desktop app that runs AI agents through a structured clarify-design-plan-code-verify workflow, covering coding, UI design, and long-form writing in one place.

Mindmap

mindmap
  root((kun))
    Inputs
      Requirements
      Project folders
      Text descriptions
    Outputs
      Code changes
      UI mockups
      Exported documents
    Use Cases
      Draft feature and hand off to dev
      Design and prototype UI
      Write and export long docs
    Tech Stack
      TypeScript
      DeepSeek
      Xiaomi MiMo
      MiniMax
    Audience
      Product managers
      Solo founders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Draft a feature requirement, generate a visual prototype, and hand off an implementation plan to a developer.

REASON 2

Use Code mode to read files, run commands, and edit code in a local project with a review panel before committing.

REASON 3

Use Design mode to generate UI mockups and interactive prototypes from text descriptions.

REASON 4

Write and export long-form product documents to HTML, PDF, or Word using Write mode.

What's in the stack?

TypeScriptDeepSeekXiaomi MiMoMiniMax

How it stacks up

kunagent/kunfacebook/astryxlmstudio-ai/lms
Stars5,0325,0004,799
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-03
MaintenanceActive
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencepm founderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Licensed for non-commercial use only, commercial use requires separate written permission.

Free for learning and non-commercial use, any commercial use requires separate written permission.

Wtf does this do

Kun is a desktop application that brings AI agents into your daily work through a structured workflow. Instead of starting with a quick chat prompt and hoping for the best, it walks you through a full process: clarify what you need, create design mockups, plan the work, write the code, and then verify the results against the original requirements. It runs on macOS, Windows, and Linux. The app has three main modes. Code mode connects to your local project folders and can read files, run commands, and edit code while showing you a review panel before any changes are committed. Design mode generates UI mockups, interactive prototypes, and shared design systems from your requirements or text descriptions. Write mode is a standalone workspace for long-form documents with export options to HTML, PDF, and Word formats. All three modes share the same session history, approval settings, and model configuration. A product manager could use it to draft a feature requirement, generate a visual prototype, turn that into an implementation plan, and hand off to a developer who reviews and executes the plan in Code mode. A solo founder could write product docs, design interfaces, and manage code changes in one place. It also supports connecting to messaging apps like Feishu or WeChat to trigger tasks remotely, and includes a visual workflow builder for automating multi-step agent processes. What makes this project notable is its choice of AI models. Rather than defaulting to expensive providers, it centers on three Chinese model services, DeepSeek, Xiaomi MiMo, and MiniMax, chosen for their low cost across text, reasoning, vision, voice, image, music, and video generation. The idea is that a longer, multi-step workflow only works if you can afford to run it repeatedly. You can add other providers, but the default setup is designed around keeping the full pipeline cheap enough for everyday use. The project is licensed for non-commercial use only, meaning it is available for learning and reference but requires separate written permission for any commercial application.

Yoink these prompts

Prompt 1
Using Kun's Code mode, connect to my local project folder and propose a review-panel diff for adding a new API endpoint.
Prompt 2
Use Kun's Design mode to generate a UI mockup and interactive prototype from this feature description: [describe feature].
Prompt 3
Set up Kun's Write mode to draft a product requirements document and export it to PDF when finished.
Prompt 4
Configure Kun to use DeepSeek as the default model across Code, Design, and Write modes to keep the workflow cheap.
Prompt 5
Show me how to connect Kun's visual workflow builder to Feishu so a message can trigger a multi-step agent task.

Frequently asked questions

wtf is kun?

A cross-platform desktop app that runs AI agents through a structured clarify-design-plan-code-verify workflow, covering coding, UI design, and long-form writing in one place.

What language is kun written in?

Mainly TypeScript. The stack also includes TypeScript, DeepSeek, Xiaomi MiMo.

Is kun actively maintained?

Active — commit in last 30 days (last push 2026-07-03).

What license does kun use?

Free for learning and non-commercial use, any commercial use requires separate written permission.

How hard is kun to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is kun for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.