# typc-2025/prompt-optimizer architecture

> Architecture diagram of the GitHub repository typc-2025/prompt-optimizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/typc-2025/prompt-optimizer
- Repository: https://github.com/typc-2025/prompt-optimizer

## Overview

Prompt Optimizer is a multi-client AI prompt workspace. The main workflow is to enter a prompt, optimize or iterate it with a configured model, then inspect and test the result; evaluation, image generation, variable-driven prompts, and MCP access are additional product branches. The graph combines README-documented capabilities with source-index references and excerpted session orchestration. Several domain-service internals and client wiring were not sampled, so their relationships are omitted or shown as unverified rather than inferred from package structure.

Main entry points: [`packages/core/src/services/prompt/service.ts`](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/prompt/service.ts) (Prompt optimization), [`packages/ui/src/stores/session/useSessionManager.ts`](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/ui/src/stores/session/useSessionManager.ts) (Session coordinator), [`packages/desktop/main.js`](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/desktop/main.js) (Desktop app), [`packages/core/src/services/storage`](https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/core/src/services/storage) (Storage providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web["Web app<br/>[main.ts]"]
  node_desktop["Desktop app<br/>[main.js]"]
  node_extension["Browser extension<br/>[main.ts]"]
  node_mcp["MCP server<br/>[index.ts]"]
end

subgraph group_workflow["Prompt workflow"]
  node_sessions["Session coordinator"]
  node_session_modes["Prompt mode sessions"]
  node_prompt_service["Prompt optimization<br/>[service.ts]"]
  node_templates["Prompt templates<br/>[manager.ts]"]
  node_evaluation["Evaluation and compare<br/>[service.ts]"]
  node_rewrite["Evaluation rewrite"]
end

subgraph group_models["Models and generation"]
  node_text_models["Text model configuration<br/>[manager.ts]"]
  node_llm["LLM providers<br/>[service.ts]"]
  node_image_models["Image model configuration<br/>[manager.ts]"]
  node_image_generation["Image generation<br/>[service.ts]"]
  node_image_understanding["Image understanding<br/>[service.ts]"]
end

subgraph group_workspace["Workspace features"]
  node_variables["Prompt variables<br/>[VariableManager.ts]"]
  node_variable_services["Variable extraction and generation"]
  node_history["Prompt history<br/>[manager.ts]"]
  node_favorites["Saved favorites<br/>[manager.ts]"]
end

subgraph group_platform["Integration and persistence"]
  node_storage[("Storage providers")]
  node_desktop_bridge["Desktop IPC services<br/>[main.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_web
node_user -->|"uses"| node_desktop
node_user -->|"uses"| node_extension
node_web -.->|"starts workflow"| node_sessions
node_desktop -.->|"starts workflow"| node_sessions
node_extension -.->|"starts workflow"| node_sessions
node_sessions -->|"saves and restores"| node_session_modes
node_user -->|"submits prompt"| node_prompt_service
node_prompt_service -.->|"uses templates"| node_templates
node_prompt_service -->|"optimizes with"| node_llm
node_user -->|"requests evaluation"| node_evaluation
node_evaluation -.->|"rewrites from evaluation"| node_rewrite
node_user -->|"requests image"| node_image_generation
node_image_generation -.->|"uses configured model"| node_image_models
node_user -->|"submits image"| node_image_understanding
node_user -->|"manages variables"| node_variables
node_variables -.->|"extracts or generates"| node_variable_services
node_user -.->|"reviews history"| node_history
node_user -.->|"saves favorites"| node_favorites
node_mcp -->|"offers prompt tools"| node_user
node_mcp -.->|"optimizes prompts"| node_prompt_service
node_text_models -->|"provides configuration"| node_llm
node_desktop -->|"handles IPC"| node_desktop_bridge
node_desktop_bridge -.->|"uses persistence"| node_storage
node_history -.->|"persists records"| node_storage
node_favorites -->|"persists favorites"| node_storage

click node_web "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/web/src/main.ts"
click node_desktop "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/desktop/main.js"
click node_extension "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/extension/src/main.ts"
click node_mcp "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/mcp-server/src/index.ts"
click node_sessions "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/ui/src/stores/session/useSessionManager.ts"
click node_session_modes "https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/ui/src/stores/session"
click node_prompt_service "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/prompt/service.ts"
click node_templates "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/template/manager.ts"
click node_evaluation "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/service.ts"
click node_rewrite "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/rewrite-from-evaluation.ts"
click node_text_models "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/model/manager.ts"
click node_llm "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/llm/service.ts"
click node_image_models "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image-model/manager.ts"
click node_image_generation "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image/service.ts"
click node_image_understanding "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image-understanding/service.ts"
click node_variables "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/ui/src/services/VariableManager.ts"
click node_variable_services "https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/core/src/services/variable-extraction"
click node_history "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/history/manager.ts"
click node_favorites "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/favorite/manager.ts"
click node_storage "https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/core/src/services/storage"
click node_desktop_bridge "https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/desktop/main.js"

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_web,node_desktop,node_extension,node_mcp,node_user toneBlue
class node_sessions,node_session_modes,node_prompt_service,node_templates,node_evaluation,node_rewrite toneAmber
class node_text_models,node_llm,node_image_models,node_image_generation,node_image_understanding toneMint
class node_variables,node_variable_services,node_history,node_favorites toneRose
class node_storage,node_desktop_bridge toneIndigo
```

## Components

### User clients

- [Web app](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/web/src/main.ts): `packages/web/src/main.ts`
- [Desktop app](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/desktop/main.js): `packages/desktop/main.js`
- [Browser extension](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/extension/src/main.ts): `packages/extension/src/main.ts`
- [MCP server](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/mcp-server/src/index.ts): `packages/mcp-server/src/index.ts`

### Prompt workflow

- [Session coordinator](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/ui/src/stores/session/useSessionManager.ts): `packages/ui/src/stores/session/useSessionManager.ts`
- [Prompt mode sessions](https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/ui/src/stores/session): `packages/ui/src/stores/session`
- [Prompt optimization](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/prompt/service.ts): `packages/core/src/services/prompt/service.ts`
- [Prompt templates](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/template/manager.ts): `packages/core/src/services/template/manager.ts`
- [Evaluation and compare](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/service.ts): `packages/core/src/services/evaluation/service.ts`
- [Evaluation rewrite](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/rewrite-from-evaluation.ts): `packages/core/src/services/evaluation/rewrite-from-evaluation.ts`

### Models and generation

- [Text model configuration](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/model/manager.ts): `packages/core/src/services/model/manager.ts`
- [LLM providers](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/llm/service.ts): `packages/core/src/services/llm/service.ts`
- [Image model configuration](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image-model/manager.ts): `packages/core/src/services/image-model/manager.ts`
- [Image generation](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image/service.ts): `packages/core/src/services/image/service.ts`
- [Image understanding](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/image-understanding/service.ts): `packages/core/src/services/image-understanding/service.ts`

### Workspace features

- [Prompt variables](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/ui/src/services/VariableManager.ts): `packages/ui/src/services/VariableManager.ts`
- [Variable extraction and generation](https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/core/src/services/variable-extraction): `packages/core/src/services/variable-extraction`
- [Prompt history](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/history/manager.ts): `packages/core/src/services/history/manager.ts`
- [Saved favorites](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/core/src/services/favorite/manager.ts): `packages/core/src/services/favorite/manager.ts`

### Integration and persistence

- [Storage providers](https://github.com/typc-2025/prompt-optimizer/tree/develop/packages/core/src/services/storage): `packages/core/src/services/storage`
- [Desktop IPC services](https://github.com/typc-2025/prompt-optimizer/blob/develop/packages/desktop/main.js): `packages/desktop/main.js`

### Other components

- **User**

## Connections

- User → Web app: uses (evidence: `README.md`)
- User → Desktop app: uses (evidence: `README.md`)
- User → Browser extension: uses (evidence: `README.md`)
- Web app → Session coordinator: starts workflow
- Desktop app → Session coordinator: starts workflow
- Browser extension → Session coordinator: starts workflow
- Session coordinator → Prompt mode sessions: saves and restores (evidence: `packages/ui/src/stores/session/useSessionManager.ts`)
- User → Prompt optimization: submits prompt (evidence: `README.md`)
- Prompt optimization → Prompt templates: uses templates
- Prompt optimization → LLM providers: optimizes with (evidence: `README.md`)
- User → Evaluation and compare: requests evaluation (evidence: `README.md`)
- Evaluation and compare → Evaluation rewrite: rewrites from evaluation
- User → Image generation: requests image (evidence: `README.md`)
- Image generation → Image model configuration: uses configured model
- User → Image understanding: submits image (evidence: `README.md`)
- User → Prompt variables: manages variables (evidence: `README.md`)
- Prompt variables → Variable extraction and generation: extracts or generates
- User → Prompt history: reviews history
- User → Saved favorites: saves favorites
- MCP server → User: offers prompt tools (evidence: `README.md`)
- MCP server → Prompt optimization: optimizes prompts
- Text model configuration → LLM providers: provides configuration (evidence: `packages/core/src/services/model/manager.ts`)
- Desktop app → Desktop IPC services: handles IPC (evidence: `packages/desktop/main.js`)
- Desktop IPC services → Storage providers: uses persistence
- Prompt history → Storage providers: persists records
- Saved favorites → Storage providers: persists favorites (evidence: `packages/core/src/services/favorite/manager.ts`)
