# yamadashy/repomix architecture

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

- Interactive diagram: https://gitdiagram.com/yamadashy/repomix
- Repository: https://github.com/yamadashy/repomix

## Overview

Repomix packs local or remote repositories into AI-friendly output, with token metrics, filtering, security checks, and optional code compression. The main CLI workflow accepts options, loads configuration, and invokes the packager; users can also pack through the website, MCP tools, or a GitHub browser extension. The README documents major product capabilities and interfaces. Some implementation links—especially inside the packager and website server—are not shown in the excerpts, so those relationships are omitted or marked unverified.

Main entry points: [`src/core/packager.ts`](https://github.com/yamadashy/repomix/blob/main/src/core/packager.ts) (Packager), [`src/cli/cliRun.ts`](https://github.com/yamadashy/repomix/blob/main/src/cli/cliRun.ts) (CLI dispatcher), [`src/cli/actions/defaultAction.ts`](https://github.com/yamadashy/repomix/blob/main/src/cli/actions/defaultAction.ts) (Local pack action), [`src/cli/actions/remoteAction.ts`](https://github.com/yamadashy/repomix/blob/main/src/cli/actions/remoteAction.ts) (Remote pack action)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and configuration"]
  node_cli["CLI dispatcher<br/>[cliRun.ts]"]
  node_config["Configuration<br/>[configLoad.ts]"]
  node_default["Local pack action<br/>[defaultAction.ts]"]
  node_remote["Remote pack action<br/>[remoteAction.ts]"]
end

subgraph group_packing["Repository packing"]
  node_git["Git repository access"]
  node_packager["Packager<br/>[packager.ts]"]
  node_files["File collection<br/>[fileCollect.ts]"]
  node_search["File filtering<br/>[fileSearch.ts]"]
  node_tree["Directory tree"]
  node_security["Secret screening<br/>[securityCheck.ts]"]
end

subgraph group_integrations["Interfaces and integrations"]
  node_mcp["MCP server and tools<br/>[mcpServer.ts]"]
  node_mcpremote["Remote MCP tool"]
  node_extension["GitHub extension button<br/>[content.ts]"]
end

subgraph group_website["Online packing"]
  node_webclient["Website pack request<br/>[usePackRequest.ts]"]
  node_webapi["Pack API client<br/>[client.ts]"]
  node_webserver["Website pack service<br/>[packAction.ts]"]
end

subgraph group_analysis["Analysis and output"]
  node_compression["Code compression<br/>[parseFile.ts]"]
  node_metrics["Token metrics"]
  node_output["Formatted output<br/>[outputGenerate.ts]"]
  node_skill["Skill generation<br/>[packSkill.ts]"]
end

node_user(("User"))
node_webuser(("Website visitor"))

node_user -->|"runs"| node_cli
node_cli -->|"dispatches"| node_default
node_cli -->|"dispatches"| node_remote
node_default -->|"loads"| node_config
node_default -->|"invokes"| node_packager
node_remote -->|"uses"| node_git
node_remote -->|"delegates"| node_default
node_mcpremote -->|"invokes"| node_cli
node_mcpremote -->|"uses runtime"| node_mcp
node_webuser -->|"submits"| node_webclient
node_webclient -->|"handles request"| node_webapi
node_webapi -.->|"sends HTTP request"| node_webserver
node_extension -->|"adds repository action"| node_user
node_packager -->|"collects files"| node_files
node_packager -->|"filters files"| node_search
node_packager -->|"generates tree"| node_tree
node_packager -->|"checks files"| node_security
node_packager -->|"parses files"| node_compression
node_packager -->|"counts tokens"| node_metrics
node_packager -.->|"generates output"| node_output
node_packager -.->|"supports skill output"| node_skill
node_user -.->|"connects"| node_mcp

click node_cli "https://github.com/yamadashy/repomix/blob/main/src/cli/cliRun.ts"
click node_config "https://github.com/yamadashy/repomix/blob/main/src/config/configLoad.ts"
click node_default "https://github.com/yamadashy/repomix/blob/main/src/cli/actions/defaultAction.ts"
click node_remote "https://github.com/yamadashy/repomix/blob/main/src/cli/actions/remoteAction.ts"
click node_git "https://github.com/yamadashy/repomix/blob/main/src/core/git/gitRepositoryHandle.ts"
click node_packager "https://github.com/yamadashy/repomix/blob/main/src/core/packager.ts"
click node_files "https://github.com/yamadashy/repomix/blob/main/src/core/file/fileCollect.ts"
click node_search "https://github.com/yamadashy/repomix/blob/main/src/core/file/fileSearch.ts"
click node_tree "https://github.com/yamadashy/repomix/blob/main/src/core/file/fileTreeGenerate.ts"
click node_security "https://github.com/yamadashy/repomix/blob/main/src/core/security/securityCheck.ts"
click node_compression "https://github.com/yamadashy/repomix/blob/main/src/core/treeSitter/parseFile.ts"
click node_metrics "https://github.com/yamadashy/repomix/blob/main/src/core/metrics/calculateMetrics.ts"
click node_output "https://github.com/yamadashy/repomix/blob/main/src/core/output/outputGenerate.ts"
click node_skill "https://github.com/yamadashy/repomix/blob/main/src/core/skill/packSkill.ts"
click node_mcp "https://github.com/yamadashy/repomix/blob/main/src/mcp/mcpServer.ts"
click node_mcpremote "https://github.com/yamadashy/repomix/blob/main/src/mcp/tools/packRemoteRepositoryTool.ts"
click node_webclient "https://github.com/yamadashy/repomix/blob/main/website/client/composables/usePackRequest.ts"
click node_webapi "https://github.com/yamadashy/repomix/blob/main/website/client/components/api/client.ts"
click node_webserver "https://github.com/yamadashy/repomix/blob/main/website/server/src/actions/packAction.ts"
click node_extension "https://github.com/yamadashy/repomix/blob/main/browser/entrypoints/content.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_cli,node_config,node_default,node_remote,node_user toneBlue
class node_git,node_packager,node_files,node_search,node_tree,node_security toneAmber
class node_mcp,node_mcpremote,node_extension toneMint
class node_webclient,node_webapi,node_webserver toneRose
class node_compression,node_metrics,node_output,node_skill,node_webuser toneIndigo
```

## Components

### CLI and configuration

- [CLI dispatcher](https://github.com/yamadashy/repomix/blob/main/src/cli/cliRun.ts): `src/cli/cliRun.ts`
- [Configuration](https://github.com/yamadashy/repomix/blob/main/src/config/configLoad.ts): `src/config/configLoad.ts`
- [Local pack action](https://github.com/yamadashy/repomix/blob/main/src/cli/actions/defaultAction.ts): `src/cli/actions/defaultAction.ts`
- [Remote pack action](https://github.com/yamadashy/repomix/blob/main/src/cli/actions/remoteAction.ts): `src/cli/actions/remoteAction.ts`

### Repository packing

- [Git repository access](https://github.com/yamadashy/repomix/blob/main/src/core/git/gitRepositoryHandle.ts): `src/core/git/gitRepositoryHandle.ts`
- [Packager](https://github.com/yamadashy/repomix/blob/main/src/core/packager.ts): `src/core/packager.ts`
- [File collection](https://github.com/yamadashy/repomix/blob/main/src/core/file/fileCollect.ts): `src/core/file/fileCollect.ts`
- [File filtering](https://github.com/yamadashy/repomix/blob/main/src/core/file/fileSearch.ts): `src/core/file/fileSearch.ts`
- [Directory tree](https://github.com/yamadashy/repomix/blob/main/src/core/file/fileTreeGenerate.ts): `src/core/file/fileTreeGenerate.ts`
- [Secret screening](https://github.com/yamadashy/repomix/blob/main/src/core/security/securityCheck.ts): `src/core/security/securityCheck.ts`

### Interfaces and integrations

- [MCP server and tools](https://github.com/yamadashy/repomix/blob/main/src/mcp/mcpServer.ts): `src/mcp/mcpServer.ts`
- [Remote MCP tool](https://github.com/yamadashy/repomix/blob/main/src/mcp/tools/packRemoteRepositoryTool.ts): `src/mcp/tools/packRemoteRepositoryTool.ts`
- [GitHub extension button](https://github.com/yamadashy/repomix/blob/main/browser/entrypoints/content.ts): `browser/entrypoints/content.ts`

### Online packing

- [Website pack request](https://github.com/yamadashy/repomix/blob/main/website/client/composables/usePackRequest.ts): `website/client/composables/usePackRequest.ts`
- [Pack API client](https://github.com/yamadashy/repomix/blob/main/website/client/components/api/client.ts): `website/client/components/api/client.ts`
- [Website pack service](https://github.com/yamadashy/repomix/blob/main/website/server/src/actions/packAction.ts): `website/server/src/actions/packAction.ts`

### Analysis and output

- [Code compression](https://github.com/yamadashy/repomix/blob/main/src/core/treeSitter/parseFile.ts): `src/core/treeSitter/parseFile.ts`
- [Token metrics](https://github.com/yamadashy/repomix/blob/main/src/core/metrics/calculateMetrics.ts): `src/core/metrics/calculateMetrics.ts`
- [Formatted output](https://github.com/yamadashy/repomix/blob/main/src/core/output/outputGenerate.ts): `src/core/output/outputGenerate.ts`
- [Skill generation](https://github.com/yamadashy/repomix/blob/main/src/core/skill/packSkill.ts): `src/core/skill/packSkill.ts`

### Other components

- **User**
- **Website visitor**

## Connections

- User → CLI dispatcher: runs (evidence: `README.md`)
- CLI dispatcher → Local pack action: dispatches (evidence: `src/cli/cliRun.ts`)
- CLI dispatcher → Remote pack action: dispatches (evidence: `src/cli/cliRun.ts`)
- Local pack action → Configuration: loads (evidence: `src/cli/actions/defaultAction.ts`)
- Local pack action → Packager: invokes (evidence: `src/cli/actions/defaultAction.ts`)
- Remote pack action → Git repository access: uses (evidence: `src/cli/actions/remoteAction.ts`)
- Remote pack action → Local pack action: delegates (evidence: `src/cli/actions/remoteAction.ts`)
- Remote MCP tool → CLI dispatcher: invokes (evidence: `src/mcp/tools/packRemoteRepositoryTool.ts`)
- Remote MCP tool → MCP server and tools: uses runtime (evidence: `src/mcp/tools/packRemoteRepositoryTool.ts`)
- Website visitor → Website pack request: submits (evidence: `README.md`)
- Website pack request → Pack API client: handles request (evidence: `website/client/composables/usePackRequest.ts`)
- Pack API client → Website pack service: sends HTTP request
- GitHub extension button → User: adds repository action (evidence: `README.md`)
- Packager → File collection: collects files (evidence: `src/index.ts`)
- Packager → File filtering: filters files (evidence: `src/index.ts`)
- Packager → Directory tree: generates tree (evidence: `src/index.ts`)
- Packager → Secret screening: checks files (evidence: `src/index.ts`)
- Packager → Code compression: parses files (evidence: `src/index.ts`)
- Packager → Token metrics: counts tokens
- Packager → Formatted output: generates output
- Packager → Skill generation: supports skill output
- User → MCP server and tools: connects
