# krillinai/klicstudio architecture

> Architecture diagram of the GitHub repository krillinai/klicstudio, 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/krillinai/klicstudio
- Repository: https://github.com/krillinai/klicstudio

## Overview

OpenCreator is a local AI workspace for creative tools and agent-driven work. Users start in the shared Web workspace, select a visual creator workflow or converse with an agent, then monitor progress and review outputs. The daemon provides the local API, creator execution, and Codex-backed runs; desktop hosts the same Web client and starts the daemon. The graph also retains documented capabilities such as Skills, MCP, schedules, memory, and video translation. Some subsystems are represented by their exact source directories because their implementation was not sampled; links without direct evidence are omitted.

Main entry points: [`apps/daemon/src/runs/manager.ts`](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/runs/manager.ts) (Run manager), [`apps/daemon/src/creator/service.ts`](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/service.ts) (Creator service), [`apps/web/src/app/AppController.tsx`](https://github.com/krillinai/klicstudio/blob/master/apps/web/src/app/AppController.tsx) (Web workspace), [`apps/daemon/src/api/routes.creator.ts`](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/routes.creator.ts) (Creator routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Workspace clients"]
  node_web["Web workspace<br/>[AppController.tsx]"]
  node_creator_ui["Creator dashboard"]
  node_desktop["Desktop host<br/>[daemon-manager.ts]"]
end

subgraph group_runtime["Local runtime"]
  node_api["Local API<br/>[server.ts]"]
  node_creator_routes["Creator routes<br/>[routes.creator.ts]"]
  node_run_api["Run routes<br/>[routes.runs.ts]"]
  node_run_events["Run event stream<br/>[sse.ts]"]
end

subgraph group_creation["Creator workflows"]
  node_creator_service["Creator service<br/>[service.ts]"]
  node_dispatch["Command dispatcher"]
  node_stage_runner["Stage runner<br/>[stage-runner.ts]"]
  node_creator_repo[("Creator repository<br/>[repository.ts]")]
  node_translation["Video translation<br/>[executor.ts]"]
end

subgraph group_agent["Agent capabilities"]
  node_agent_tools["Agent tools<br/>[creator-tools.ts]"]
  node_run_injection["Run tool injection<br/>[run-injection.ts]"]
  node_run_manager["Run manager<br/>[manager.ts]"]
  node_codex["Codex execution"]
  node_skills_mcp["Skills and MCP"]
  node_schedule["Schedules"]
end

subgraph group_state["Local state"]
  node_project_manager["Project manager<br/>[manager.ts]"]
  node_storage[("SQLite storage<br/>[database.ts]")]
  node_repositories["Data repositories<br/>[repositories.ts]"]
end

node_user(("Creator or developer"))

node_user -->|"uses"| node_web
node_web -->|"opens tools"| node_creator_ui
node_web -->|"uses runtime"| node_api
node_desktop -->|"starts daemon"| node_api
node_creator_ui -->|"submits work"| node_creator_routes
node_api -.->|"routes requests"| node_creator_routes
node_creator_routes -->|"invokes"| node_creator_service
node_creator_routes -->|"reads and writes"| node_creator_repo
node_creator_service -.->|"dispatches commands"| node_dispatch
node_creator_service -->|"runs stages"| node_stage_runner
node_creator_service -.->|"persists jobs"| node_creator_repo
node_user -->|"requests translation"| node_translation
node_web -->|"submits agent work"| node_run_api
node_run_api -.->|"manages runs"| node_run_manager
node_run_manager -->|"injects tools"| node_run_injection
node_run_manager -->|"executes runs"| node_codex
node_codex -->|"configures runtime"| node_run_injection
node_agent_tools -->|"calls creator"| node_creator_service
node_run_injection -->|"registers tools"| node_agent_tools
node_run_manager -->|"stores run state"| node_repositories
node_project_manager -->|"uses repositories"| node_repositories
node_repositories -->|"uses database"| node_storage
node_storage -->|"applies migrations"| node_storage
node_run_manager -.->|"publishes progress"| node_run_events
node_user -->|"extends agent"| node_skills_mcp
node_user -->|"schedules work"| node_schedule

click node_web "https://github.com/krillinai/klicstudio/blob/master/apps/web/src/app/AppController.tsx"
click node_creator_ui "https://github.com/krillinai/klicstudio/blob/master/apps/web/src/features/dashboard/creator-workspace.ts"
click node_desktop "https://github.com/krillinai/klicstudio/blob/master/apps/desktop/src/main/daemon-manager.ts"
click node_api "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/server.ts"
click node_creator_routes "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/routes.creator.ts"
click node_run_api "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/routes.runs.ts"
click node_creator_service "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/service.ts"
click node_dispatch "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/command-dispatcher.ts"
click node_stage_runner "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/stage-runner.ts"
click node_creator_repo "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/repository.ts"
click node_translation "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/smart-dubbing/executor.ts"
click node_agent_tools "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/agent-tools/creator-tools.ts"
click node_run_injection "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/agent-tools/run-injection.ts"
click node_run_manager "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/runs/manager.ts"
click node_codex "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/codex/app-server-runtime-manager.ts"
click node_skills_mcp "https://github.com/krillinai/klicstudio/tree/master/apps/daemon/src/codex/skills"
click node_schedule "https://github.com/krillinai/klicstudio/tree/master/apps/daemon/src/scheduler"
click node_project_manager "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/projects/manager.ts"
click node_storage "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/storage/database.ts"
click node_repositories "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/storage/repositories.ts"
click node_run_events "https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/sse.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_web,node_creator_ui,node_desktop toneBlue
class node_api,node_creator_routes,node_run_api,node_run_events toneAmber
class node_creator_service,node_dispatch,node_stage_runner,node_creator_repo,node_translation toneMint
class node_agent_tools,node_run_injection,node_run_manager,node_codex,node_skills_mcp,node_schedule toneRose
class node_project_manager,node_storage,node_repositories,node_user toneIndigo
```

## Components

### Workspace clients

- [Web workspace](https://github.com/krillinai/klicstudio/blob/master/apps/web/src/app/AppController.tsx): `apps/web/src/app/AppController.tsx`
- [Creator dashboard](https://github.com/krillinai/klicstudio/blob/master/apps/web/src/features/dashboard/creator-workspace.ts): `apps/web/src/features/dashboard/creator-workspace.ts`
- [Desktop host](https://github.com/krillinai/klicstudio/blob/master/apps/desktop/src/main/daemon-manager.ts): `apps/desktop/src/main/daemon-manager.ts`

### Local runtime

- [Local API](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/server.ts): `apps/daemon/src/api/server.ts`
- [Creator routes](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/routes.creator.ts): `apps/daemon/src/api/routes.creator.ts`
- [Run routes](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/routes.runs.ts): `apps/daemon/src/api/routes.runs.ts`
- [Run event stream](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/api/sse.ts): `apps/daemon/src/api/sse.ts`

### Creator workflows

- [Creator service](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/service.ts): `apps/daemon/src/creator/service.ts`
- [Command dispatcher](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/command-dispatcher.ts): `apps/daemon/src/creator/command-dispatcher.ts`
- [Stage runner](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/stage-runner.ts): `apps/daemon/src/creator/stage-runner.ts`
- [Creator repository](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/repository.ts): `apps/daemon/src/creator/repository.ts`
- [Video translation](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/creator/smart-dubbing/executor.ts): `apps/daemon/src/creator/smart-dubbing/executor.ts`

### Agent capabilities

- [Agent tools](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/agent-tools/creator-tools.ts): `apps/daemon/src/agent-tools/creator-tools.ts`
- [Run tool injection](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/agent-tools/run-injection.ts): `apps/daemon/src/agent-tools/run-injection.ts`
- [Run manager](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/runs/manager.ts): `apps/daemon/src/runs/manager.ts`
- [Codex execution](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/codex/app-server-runtime-manager.ts): `apps/daemon/src/codex/app-server-runtime-manager.ts`
- [Skills and MCP](https://github.com/krillinai/klicstudio/tree/master/apps/daemon/src/codex/skills): `apps/daemon/src/codex/skills`
- [Schedules](https://github.com/krillinai/klicstudio/tree/master/apps/daemon/src/scheduler): `apps/daemon/src/scheduler`

### Local state

- [Project manager](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/projects/manager.ts): `apps/daemon/src/projects/manager.ts`
- [SQLite storage](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/storage/database.ts): `apps/daemon/src/storage/database.ts`
- [Data repositories](https://github.com/krillinai/klicstudio/blob/master/apps/daemon/src/storage/repositories.ts): `apps/daemon/src/storage/repositories.ts`

### Other components

- **Creator or developer**

## Connections

- Creator or developer → Web workspace: uses (evidence: `README.md`)
- Web workspace → Creator dashboard: opens tools (evidence: `apps/web/src/app/AppController.tsx`)
- Web workspace → Local API: uses runtime (evidence: `README.md`)
- Desktop host → Local API: starts daemon (evidence: `apps/desktop/src/main/daemon-manager.ts`)
- Creator dashboard → Creator routes: submits work (evidence: `README.md`)
- Local API → Creator routes: routes requests
- Creator routes → Creator service: invokes (evidence: `apps/daemon/src/api/routes.creator.ts`)
- Creator routes → Creator repository: reads and writes (evidence: `apps/daemon/src/api/routes.creator.ts`)
- Creator service → Command dispatcher: dispatches commands
- Creator service → Stage runner: runs stages (evidence: `apps/daemon/src/api/routes.creator.ts`)
- Creator service → Creator repository: persists jobs
- Creator or developer → Video translation: requests translation (evidence: `README.md`)
- Web workspace → Run routes: submits agent work (evidence: `README.md`)
- Run routes → Run manager: manages runs
- Run manager → Run tool injection: injects tools (evidence: `apps/daemon/src/runs/manager.ts`)
- Run manager → Codex execution: executes runs (evidence: `apps/daemon/src/runs/manager.ts`)
- Codex execution → Run tool injection: configures runtime (evidence: `apps/daemon/src/codex/app-server-runtime-manager.ts`)
- Agent tools → Creator service: calls creator (evidence: `apps/daemon/src/agent-tools/creator-tools.ts`)
- Run tool injection → Agent tools: registers tools (evidence: `apps/daemon/src/agent-tools/run-injection.ts`)
- Run manager → Data repositories: stores run state (evidence: `apps/daemon/src/runs/manager.ts`)
- Project manager → Data repositories: uses repositories (evidence: `apps/daemon/src/projects/manager.ts`)
- Data repositories → SQLite storage: uses database (evidence: `apps/daemon/src/storage/repositories.ts`)
- SQLite storage → SQLite storage: applies migrations (evidence: `apps/daemon/src/storage/database.ts`)
- Run manager → Run event stream: publishes progress
- Creator or developer → Skills and MCP: extends agent (evidence: `README.md`)
- Creator or developer → Schedules: schedules work (evidence: `README.md`)
