# linshenkx/prompt-optimizer architecture

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

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

## Overview

Prompt Optimizer is a client-side prompt workbench delivered as web, desktop, and extension apps, with an MCP integration. Users bring or create prompts, optimize and test them with configured AI models, evaluate results, and save reusable assets. Its documented branches include image generation, advanced variable and conversation testing, favorites with versioned resources, and backup/import. The graph reflects documented workflows and sampled UI/core references; several core implementations and some UI wiring were not sampled, so uncertain calls are omitted.

Main entry points: [`packages/core/src/services/llm/service.ts`](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/llm/service.ts) (Text model service), [`packages/web/src/App.vue`](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/web/src/App.vue) (Web, desktop, extension), [`packages/core/src/services/data/manager.ts`](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/data/manager.ts) (Import and export), [`packages/core/src/services/image/service.ts`](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image/service.ts) (Image generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Product interfaces"]
  node_apps["Web, desktop, extension<br/>[App.vue]"]
end

subgraph group_prompt["Prompt workflows"]
  node_sessions["Prompt sessions"]
  node_templates["Templates<br/>[manager.ts]"]
  node_promptsvc["Prompt optimization<br/>[service.ts]"]
  node_variables["Variables"]
  node_evaluation["Evaluation and compare<br/>[service.ts]"]
  node_imagegen["Image generation<br/>[service.ts]"]
end

subgraph group_models["AI model services"]
  node_modelui["Model configuration"]
  node_modelmgr["Model manager<br/>[manager.ts]"]
  node_llm["Text model service<br/>[service.ts]"]
  node_llmadapters["Text provider adapters<br/>[registry.ts]"]
  node_imagemgr["Image model manager<br/>[manager.ts]"]
  node_imageadapters["Image provider adapters<br/>[registry.ts]"]
end

subgraph group_assets["Prompt assets and data"]
  node_favorites["Favorites and versions<br/>[manager.ts]"]
  node_history["Prompt history<br/>[manager.ts]"]
  node_data["Import and export<br/>[manager.ts]"]
  node_backup["Remote backups<br/>[useDataManager.ts]"]
  node_storage[("Storage providers")]
end

subgraph group_integrations["External integrations"]
  node_mcp["MCP server<br/>[core-services.ts]"]
  node_ai(("AI providers"))
end

node_user(("Prompt creator"))

node_user -->|"uses"| node_apps
node_apps -.->|"manages sessions"| node_sessions
node_user -->|"starts from templates"| node_templates
node_user -->|"optimizes prompts"| node_promptsvc
node_user -->|"tests with variables"| node_variables
node_user -->|"evaluates results"| node_evaluation
node_user -->|"generates images"| node_imagegen
node_user -->|"saves prompts"| node_favorites
node_user -->|"imports or exports"| node_data
node_modelui -->|"configures models"| node_modelmgr
node_promptsvc -.->|"uses models"| node_llm
node_evaluation -.->|"uses models"| node_llm
node_llm -.->|"dispatches providers"| node_llmadapters
node_ai -->|"receives requests"| node_llm
node_imagegen -.->|"uses image models"| node_imagemgr
node_imagemgr -.->|"dispatches providers"| node_imageadapters
node_ai -->|"receives requests"| node_imagegen
node_apps -.->|"offers MCP integration"| node_mcp
node_data -->|"backs up data"| node_backup
node_data -.->|"persists data"| node_storage
node_sessions -->|"hydrates history"| node_history

click node_apps "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/web/src/App.vue"
click node_mcp "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/mcp-server/src/adapters/core-services.ts"
click node_sessions "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/stores/session/useSessionManager.ts"
click node_templates "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/template/manager.ts"
click node_promptsvc "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/prompt/service.ts"
click node_variables "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/composables/prompt/useVariableManager.ts"
click node_evaluation "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/service.ts"
click node_imagegen "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image/service.ts"
click node_modelui "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/composables/model/useTextModelManager.ts"
click node_modelmgr "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/model/manager.ts"
click node_llm "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/llm/service.ts"
click node_llmadapters "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/llm/adapters/registry.ts"
click node_imagemgr "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image-model/manager.ts"
click node_imageadapters "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image/adapters/registry.ts"
click node_favorites "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/favorite/manager.ts"
click node_history "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/history/manager.ts"
click node_data "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/data/manager.ts"
click node_backup "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/components/data-manager/useDataManager.ts"
click node_storage "https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/storage/dexieStorageProvider.ts"

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_apps toneBlue
class node_sessions,node_templates,node_promptsvc,node_variables,node_evaluation,node_imagegen toneAmber
class node_modelui,node_modelmgr,node_llm,node_llmadapters,node_imagemgr,node_imageadapters toneMint
class node_favorites,node_history,node_data,node_backup,node_storage toneRose
class node_mcp,node_ai,node_user toneIndigo
```

## Components

### Product interfaces

- [Web, desktop, extension](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/web/src/App.vue): `packages/web/src/App.vue`

### Prompt workflows

- [Prompt sessions](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/stores/session/useSessionManager.ts): `packages/ui/src/stores/session/useSessionManager.ts`
- [Templates](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/template/manager.ts): `packages/core/src/services/template/manager.ts`
- [Prompt optimization](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/prompt/service.ts): `packages/core/src/services/prompt/service.ts`
- [Variables](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/composables/prompt/useVariableManager.ts): `packages/ui/src/composables/prompt/useVariableManager.ts`
- [Evaluation and compare](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/evaluation/service.ts): `packages/core/src/services/evaluation/service.ts`
- [Image generation](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image/service.ts): `packages/core/src/services/image/service.ts`

### AI model services

- [Model configuration](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/composables/model/useTextModelManager.ts): `packages/ui/src/composables/model/useTextModelManager.ts`
- [Model manager](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/model/manager.ts): `packages/core/src/services/model/manager.ts`
- [Text model service](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/llm/service.ts): `packages/core/src/services/llm/service.ts`
- [Text provider adapters](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/llm/adapters/registry.ts): `packages/core/src/services/llm/adapters/registry.ts`
- [Image model manager](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image-model/manager.ts): `packages/core/src/services/image-model/manager.ts`
- [Image provider adapters](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/image/adapters/registry.ts): `packages/core/src/services/image/adapters/registry.ts`

### Prompt assets and data

- [Favorites and versions](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/favorite/manager.ts): `packages/core/src/services/favorite/manager.ts`
- [Prompt history](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/history/manager.ts): `packages/core/src/services/history/manager.ts`
- [Import and export](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/data/manager.ts): `packages/core/src/services/data/manager.ts`
- [Remote backups](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/ui/src/components/data-manager/useDataManager.ts): `packages/ui/src/components/data-manager/useDataManager.ts`
- [Storage providers](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/core/src/services/storage/dexieStorageProvider.ts): `packages/core/src/services/storage/dexieStorageProvider.ts`

### External integrations

- [MCP server](https://github.com/linshenkx/prompt-optimizer/blob/develop/packages/mcp-server/src/adapters/core-services.ts): `packages/mcp-server/src/adapters/core-services.ts`
- **AI providers**

### Other components

- **Prompt creator**

## Connections

- Prompt creator → Web, desktop, extension: uses (evidence: `README.md`)
- Web, desktop, extension → Prompt sessions: manages sessions
- Prompt creator → Templates: starts from templates (evidence: `README.md`)
- Prompt creator → Prompt optimization: optimizes prompts (evidence: `README.md`)
- Prompt creator → Variables: tests with variables (evidence: `README.md`)
- Prompt creator → Evaluation and compare: evaluates results (evidence: `README.md`)
- Prompt creator → Image generation: generates images (evidence: `README.md`)
- Prompt creator → Favorites and versions: saves prompts (evidence: `README.md`)
- Prompt creator → Import and export: imports or exports (evidence: `README.md`)
- Model configuration → Model manager: configures models (evidence: `packages/ui/src/composables/model/useTextModelManager.ts`)
- Prompt optimization → Text model service: uses models
- Evaluation and compare → Text model service: uses models
- Text model service → Text provider adapters: dispatches providers
- AI providers → Text model service: receives requests (evidence: `README.md`)
- Image generation → Image model manager: uses image models
- Image model manager → Image provider adapters: dispatches providers
- AI providers → Image generation: receives requests (evidence: `README.md`)
- Web, desktop, extension → MCP server: offers MCP integration
- Import and export → Remote backups: backs up data (evidence: `packages/ui/src/components/data-manager/useDataManager.ts`)
- Import and export → Storage providers: persists data
- Prompt sessions → Prompt history: hydrates history (evidence: `packages/ui/src/stores/session/useSessionManager.ts`)
