gitwtfhub

wtf is nimruz-desktop?

xmannii/nimruz-desktop — explained in plain English

Analysis updated 2026-05-18

45TypeScriptAudience · vibe coderComplexity · 2/5Setup · moderate

TL;DR

An open-source Persian-language desktop AI workspace agent that can chat, read and edit project files, and run tools with your approval.

Mindmap

mindmap
  root((repo))
    What it does
      Persian AI chat
      Workspace file agent
    Tech stack
      Electron
      React
      TypeScript
    Providers
      Codex via ChatGPT
      OpenRouter
    Use cases
      Local AI assistant
      In-folder coding help
    Audience
      Vibe coders
      Persian speakers

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

Chat with an AI assistant in a Persian right-to-left desktop interface

REASON 2

Let an AI agent read, search, and edit files inside a linked project workspace

REASON 3

Use a ChatGPT account to access OpenAI's Codex model inside a desktop app

REASON 4

Save reusable experts, skills, and memories for recurring assistant tasks

What's in the stack?

TypeScriptElectronReactSQLite

How it stacks up

xmannii/nimruz-desktopi4w7w4a/liquid_prnc_glassqunabu/gravity
Stars454545
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity2/53/53/5
Audiencevibe coderdevelopergeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

macOS builds are unsigned, so Gatekeeper may block first launch until you allow it manually.

The README does not state a license for the project.

Wtf does this do

Nimruz Desktop is an open-source desktop app that gives you a chat assistant with a Persian, right-to-left interface, built for people who want to work with AI language models directly on their own files rather than only chatting in a browser tab. It is built with Electron, React, and the Vercel AI SDK, and works on Windows and macOS, with Linux support available if you build it yourself. Beyond plain chat, Nimruz can act as a workspace agent: you link a project folder, and the assistant can read, search, and write files, run shell commands, and produce artifacts and tasks inside that folder, asking for your approval before anything risky runs. You can connect it to a ChatGPT account to use OpenAI's Codex model, or bring your own key through OpenRouter or another compatible provider. When using Codex through a ChatGPT sign-in, the app runs it with a restricted setup that limits which files it can touch and blocks network access and several other tool types for safety. Other features include reusable saved experts and skills you can call up while chatting, a memory system that lets the assistant save and later forget specific facts, streaming responses with support for code, math, and diagrams, and light, dark, and system color themes. Everything is stored locally on your machine in an SQLite database, and provider API keys are kept in your operating system's secure keychain rather than in a plain text file. To try it from source you need Node.js version 22.12 or newer and the pnpm package manager, then you clone the repository, run pnpm install, and start it with pnpm dev. Pre-built installers for Windows and macOS are also published with each release, though the macOS build is not yet signed or notarized, so macOS may initially warn that the app looks damaged. The README does not state a software license for the project.

Yoink these prompts

Prompt 1
Install Nimruz Desktop from source using pnpm and run it in dev mode
Prompt 2
Connect my ChatGPT account to use Codex inside Nimruz
Prompt 3
Link a project folder as a workspace so the agent can edit its files
Prompt 4
Set up OpenRouter as a model provider in Nimruz's settings
Prompt 5
Explain what approvals and artifacts mean in Nimruz's agentic workspace

Frequently asked questions

wtf is nimruz-desktop?

An open-source Persian-language desktop AI workspace agent that can chat, read and edit project files, and run tools with your approval.

What language is nimruz-desktop written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, React.

What license does nimruz-desktop use?

The README does not state a license for the project.

How hard is nimruz-desktop to set up?

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

Who is nimruz-desktop for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

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