# the-priyankaa/yuki-ide architecture

> Architecture diagram of the GitHub repository the-priyankaa/yuki-ide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/the-priyankaa/yuki-ide
- Repository: https://github.com/the-priyankaa/yuki-ide

## Overview

YUKI is a zero-dependency terminal editor. The main workflow is a user opening or creating a file, editing it in the curses interface, and saving it; the interface also dispatches navigation, source-control, completion, and run-file features. The graph preserves major README capabilities, while some panels are represented by their exact enclosing directory because their implementations were not sampled. Edges cite the README or source-index files that establish the relationship; unsampled subsystem links are omitted where ownership is unclear.

Main entry points: [`core/src/stdedit/tui.py`](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/tui.py) (Curses editor), [`core/src/stdedit/buffer.py`](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/buffer.py) (Text buffer), [`core/src/stdedit`](https://github.com/the-priyankaa/yuki-ide/tree/main/core/src/stdedit) (Git and diff panels), [`core/src/stdedit/clipboard.py`](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/clipboard.py) (Clipboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Editing"]
  node_buffer["Text buffer<br/>[buffer.py]"]
  node_history["Undo and redo<br/>[undo.py]"]
  node_clipboard["Clipboard<br/>[clipboard.py]"]
  node_language["Language rules<br/>[schema.py]"]
  node_storage["Large-file storage"]
  node_suggest["Local suggestions<br/>[suggest.py]"]
end

subgraph group_interface["Terminal interface"]
  node_tui["Curses editor<br/>[tui.py]"]
  node_entry["Application entry<br/>[main.py]"]
  node_render["Safe rendering<br/>[render.py]"]
end

subgraph group_navigation["Files and panels"]
  node_dashboard["Welcome dashboard<br/>[dashboard.py]"]
  node_quickopen["Quick Open<br/>[quick_open.py]"]
  node_explorer["File explorer<br/>[explorer.py]"]
  node_recent["Recent files<br/>[recent.py]"]
  node_panels["Git and diff panels"]
  node_image["Image viewer<br/>[imageviewer.py]"]
end

subgraph group_integrations["Integrations"]
  node_ai["AI completion<br/>[codeium.py]"]
  node_extensions["Extension system<br/>[loader.py]"]
  node_runner["Run current file<br/>[runner.py]"]
end

subgraph group_preferences["Presentation"]
  node_settings[("Editor settings<br/>[settings.py]")]
  node_themes["Color themes<br/>[themes.py]"]
end

node_user(("Editor user"))
node_terminal(("Terminal"))
node_filesystem[("Local files")]
node_gitcli["Git CLI"]
node_ghcli["gh CLI"]
node_ai_service["Codeium service"]
node_system_clipboard["System clipboard"]
node_runtime["External runtime"]

node_user -->|"opens editor"| node_entry
node_entry -->|"starts interface"| node_tui
node_tui -->|"edits buffer"| node_buffer
node_buffer -->|"records changes"| node_history
node_buffer -->|"uses large-file storage"| node_storage
node_buffer -->|"gets indent rules"| node_language
node_buffer -->|"uses clipboard"| node_clipboard
node_tui -->|"highlights text"| node_language
node_tui -->|"updates suggestions"| node_suggest
node_tui -.->|"requests inline completion"| node_ai
node_tui -->|"shows dashboard"| node_dashboard
node_dashboard -->|"lists recent files"| node_recent
node_tui -->|"opens file search"| node_quickopen
node_tui -->|"shows file tree"| node_explorer
node_tui -->|"dispatches panels"| node_panels
node_tui -->|"shows image files"| node_image
node_tui -->|"loads extensions"| node_extensions
node_tui -->|"runs current file"| node_runner
node_tui -->|"reads and changes"| node_settings
node_tui -->|"applies theme"| node_themes
node_tui -->|"sanitizes display text"| node_render
node_tui -->|"draws interface"| node_terminal
node_buffer -->|"reads and saves"| node_filesystem
node_clipboard -.->|"uses system tools"| node_system_clipboard
node_panels -->|"runs Git commands"| node_gitcli
node_panels -->|"uses GitHub CLI"| node_ghcli
node_ai -.->|"requests completions"| node_ai_service
node_runner -->|"launches program"| node_runtime

click node_tui "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/tui.py"
click node_entry "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/main.py"
click node_buffer "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/buffer.py"
click node_history "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/undo.py"
click node_clipboard "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/clipboard.py"
click node_language "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/languages/schema.py"
click node_storage "https://github.com/the-priyankaa/yuki-ide/tree/main/core/src/stdedit/storage"
click node_suggest "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/suggest.py"
click node_ai "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/codeium.py"
click node_dashboard "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/dashboard.py"
click node_quickopen "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/quick_open.py"
click node_explorer "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/explorer.py"
click node_recent "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/recent.py"
click node_panels "https://github.com/the-priyankaa/yuki-ide/tree/main/core/src/stdedit"
click node_image "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/imageviewer.py"
click node_extensions "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/extensions/loader.py"
click node_runner "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/runner.py"
click node_settings "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/settings.py"
click node_themes "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/themes.py"
click node_render "https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/render.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_buffer,node_history,node_clipboard,node_language,node_storage,node_suggest,node_user toneBlue
class node_tui,node_entry,node_render,node_filesystem toneAmber
class node_dashboard,node_quickopen,node_explorer,node_recent,node_panels,node_image toneMint
class node_ai,node_extensions,node_runner toneRose
class node_settings,node_themes,node_terminal,node_gitcli,node_ghcli,node_ai_service,node_system_clipboard,node_runtime toneIndigo
```

## Components

### Editing

- [Text buffer](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/buffer.py): `core/src/stdedit/buffer.py`
- [Undo and redo](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/undo.py): `core/src/stdedit/undo.py`
- [Clipboard](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/clipboard.py): `core/src/stdedit/clipboard.py`
- [Language rules](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/languages/schema.py): `core/src/stdedit/languages/schema.py`
- [Large-file storage](https://github.com/the-priyankaa/yuki-ide/tree/main/core/src/stdedit/storage): `core/src/stdedit/storage`
- [Local suggestions](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/suggest.py): `core/src/stdedit/suggest.py`

### Terminal interface

- [Curses editor](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/tui.py): `core/src/stdedit/tui.py`
- [Application entry](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/main.py): `core/src/stdedit/main.py`
- [Safe rendering](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/render.py): `core/src/stdedit/render.py`

### Files and panels

- [Welcome dashboard](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/dashboard.py): `core/src/stdedit/dashboard.py`
- [Quick Open](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/quick_open.py): `core/src/stdedit/quick_open.py`
- [File explorer](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/explorer.py): `core/src/stdedit/explorer.py`
- [Recent files](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/recent.py): `core/src/stdedit/recent.py`
- [Git and diff panels](https://github.com/the-priyankaa/yuki-ide/tree/main/core/src/stdedit): `core/src/stdedit`
- [Image viewer](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/imageviewer.py): `core/src/stdedit/imageviewer.py`

### Integrations

- [AI completion](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/codeium.py): `core/src/stdedit/codeium.py`
- [Extension system](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/extensions/loader.py): `core/src/stdedit/extensions/loader.py`
- [Run current file](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/runner.py): `core/src/stdedit/runner.py`

### Presentation

- [Editor settings](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/settings.py): `core/src/stdedit/settings.py`
- [Color themes](https://github.com/the-priyankaa/yuki-ide/blob/main/core/src/stdedit/themes.py): `core/src/stdedit/themes.py`

### Other components

- **Editor user**
- **Terminal**
- **Local files**
- **Git CLI**
- **gh CLI**
- **Codeium service**
- **System clipboard**
- **External runtime**

## Connections

- Editor user → Application entry: opens editor (evidence: `README.md`)
- Application entry → Curses editor: starts interface (evidence: `core/src/stdedit/main.py`)
- Curses editor → Text buffer: edits buffer (evidence: `core/src/stdedit/tui.py`)
- Text buffer → Undo and redo: records changes (evidence: `core/src/stdedit/buffer.py`)
- Text buffer → Large-file storage: uses large-file storage (evidence: `core/src/stdedit/buffer.py`)
- Text buffer → Language rules: gets indent rules (evidence: `core/src/stdedit/buffer.py`)
- Text buffer → Clipboard: uses clipboard (evidence: `core/src/stdedit/buffer.py`)
- Curses editor → Language rules: highlights text (evidence: `core/src/stdedit/tui.py`)
- Curses editor → Local suggestions: updates suggestions (evidence: `core/src/stdedit/tui.py`)
- Curses editor → AI completion: requests inline completion (evidence: `README.md`)
- Curses editor → Welcome dashboard: shows dashboard (evidence: `README.md`)
- Welcome dashboard → Recent files: lists recent files (evidence: `core/src/stdedit/dashboard.py`)
- Curses editor → Quick Open: opens file search (evidence: `core/src/stdedit/tui.py`)
- Curses editor → File explorer: shows file tree (evidence: `core/src/stdedit/tui.py`)
- Curses editor → Git and diff panels: dispatches panels (evidence: `core/src/stdedit/tui.py`)
- Curses editor → Image viewer: shows image files (evidence: `README.md`)
- Curses editor → Extension system: loads extensions
- Curses editor → Run current file: runs current file (evidence: `README.md`)
- Curses editor → Editor settings: reads and changes (evidence: `core/src/stdedit/tui.py`)
- Curses editor → Color themes: applies theme (evidence: `core/src/stdedit/tui.py`)
- Curses editor → Safe rendering: sanitizes display text (evidence: `core/src/stdedit/render.py`)
- Curses editor → Terminal: draws interface (evidence: `README.md`)
- Text buffer → Local files: reads and saves (evidence: `README.md`)
- Clipboard → System clipboard: uses system tools (evidence: `README.md`)
- Git and diff panels → Git CLI: runs Git commands (evidence: `core/src/stdedit/git.py`)
- Git and diff panels → gh CLI: uses GitHub CLI (evidence: `README.md`)
- AI completion → Codeium service: requests completions (evidence: `README.md`)
- Run current file → External runtime: launches program (evidence: `README.md`)
