# tanaypatel917-lab/mars-send-youre-ai-to-space architecture

> Architecture diagram of the GitHub repository tanaypatel917-lab/mars-send-youre-ai-to-space, 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/tanaypatel917-lab/mars-send-youre-ai-to-space
- Repository: https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space

## Overview

MARS is an IDE-connected agent platform. The primary workflow starts in the CLI or VS Code, reaches the local workbench, and runs model-driven tasks against isolated workspace copies with checkpoints, artifacts, and diffs. Its broader product includes advisory research and verification, durable memory and skills, team collaboration, and offline-verified learning/evaluation paths. Edges rely on the README’s documented relationships and the shown source-index references; unsampled implementation details are not inferred.

Main entry points: [`packages/workbench/src/service.ts`](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/workbench/src/service.ts) (Workbench service), [`packages/execution/src/runtime.ts`](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/execution/src/runtime.ts) (Task execution), [`packages/specialists/src/task-routing.ts`](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/specialists/src/task-routing.ts) (Specialist routing), [`apps/cli/src/main.ts`](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/apps/cli/src/main.ts) (CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI<br/>[main.ts]"]
  node_vscode["VS Code client<br/>[controller.ts]"]
end

subgraph group_runtime["Workbench runtime"]
  node_workbench["Workbench service<br/>[service.ts]"]
  node_workspace["Isolated workspaces<br/>[provider.ts]"]
  node_execution["Task execution<br/>[runtime.ts]"]
  node_models["Model providers<br/>[router.ts]"]
  node_output["Output contract<br/>[process.ts]"]
end

subgraph group_context["Context and extensions"]
  node_watch["Screen verification<br/>[service.ts]"]
  node_browser["Browser automation<br/>[service.ts]"]
  node_research["Research control plane<br/>[service.ts]"]
  node_researchworker["Research worker<br/>[worker.ts]"]
  node_memory["Memory service<br/>[index.ts]"]
  node_skills["Skills and conventions<br/>[discovery.ts]"]
  node_knowledge["Knowledge graph<br/>[service.ts]"]
  node_browserworker["Browser worker<br/>[engine.ts]"]
end

subgraph group_collaboration["Team collaboration"]
  node_team["Team service<br/>[server.ts]"]
  node_teamchat["Team chat<br/>[service.ts]"]
end

subgraph group_learning["Learning and evaluation"]
  node_datasets["Verified datasets<br/>[builder.ts]"]
  node_training["Model training<br/>[service.ts]"]
  node_specialists["Specialist routing<br/>[task-routing.ts]"]
  node_vllm["vLLM serving<br/>[provider.ts]"]
  node_evaluation["Independent evaluation<br/>[service.ts]"]
  node_optimization["Prompt optimization<br/>[service.ts]"]
  node_evolution["Workflow evolution<br/>[service.ts]"]
end

node_user(("User"))

node_user -->|"starts commands"| node_cli
node_user -->|"submits tasks"| node_vscode
node_cli -->|"starts service"| node_workbench
node_vscode -->|"connects by RPC"| node_workbench
node_workbench -->|"isolates task copies"| node_workspace
node_workbench -->|"runs tasks"| node_execution
node_execution -->|"requests model work"| node_models
node_execution -->|"validates responses"| node_output
node_workbench -->|"loads context"| node_memory
node_workbench -->|"loads conventions"| node_skills
node_workbench -->|"starts research"| node_research
node_researchworker -->|"reports findings"| node_research
node_workbench -->|"records verification"| node_watch
node_browserworker -->|"provides browser engine"| node_browser
node_workbench -.->|"offers browser tasks"| node_browser
node_workbench -.->|"builds repository context"| node_knowledge
node_user -->|"collaborates"| node_team
node_teamchat -.->|"supports team chat"| node_team
node_datasets -->|"supplies training data"| node_training
node_training -->|"produces adapters"| node_specialists
node_specialists -->|"routes to serving"| node_vllm
node_specialists -->|"compares specialists"| node_evaluation
node_user -->|"runs comparisons"| node_evaluation
node_user -->|"optimizes prompts"| node_optimization
node_user -.->|"proposes workflows"| node_evolution

click node_cli "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/apps/cli/src/main.ts"
click node_vscode "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/apps/vscode/src/controller.ts"
click node_workbench "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/workbench/src/service.ts"
click node_workspace "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/workspaces/src/provider.ts"
click node_execution "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/execution/src/runtime.ts"
click node_models "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/providers/src/models/router.ts"
click node_output "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/output-format/src/process.ts"
click node_watch "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/watch/src/service.ts"
click node_browser "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/browser/src/service.ts"
click node_research "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/research/src/service.ts"
click node_researchworker "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/research-worker/src/worker.ts"
click node_memory "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/memory/src/index.ts"
click node_skills "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/skills/src/discovery.ts"
click node_team "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/team/src/server.ts"
click node_teamchat "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/team-chat/src/service.ts"
click node_datasets "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/datasets/src/builder.ts"
click node_training "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/training/src/service.ts"
click node_specialists "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/specialists/src/task-routing.ts"
click node_vllm "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/providers-vllm/src/provider.ts"
click node_evaluation "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/evaluation/src/service.ts"
click node_optimization "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/optimization/src/service.ts"
click node_evolution "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/evolution/src/service.ts"
click node_knowledge "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/knowledge-graph/src/service.ts"
click node_browserworker "https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/browser-worker/src/engine.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_vscode,node_user toneBlue
class node_workbench,node_workspace,node_execution,node_models,node_output toneAmber
class node_watch,node_browser,node_research,node_researchworker,node_memory,node_skills,node_knowledge,node_browserworker toneMint
class node_team,node_teamchat toneRose
class node_datasets,node_training,node_specialists,node_vllm,node_evaluation,node_optimization,node_evolution toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/apps/cli/src/main.ts): `apps/cli/src/main.ts`
- [VS Code client](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/apps/vscode/src/controller.ts): `apps/vscode/src/controller.ts`

### Workbench runtime

- [Workbench service](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/workbench/src/service.ts): `packages/workbench/src/service.ts`
- [Isolated workspaces](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/workspaces/src/provider.ts): `packages/workspaces/src/provider.ts`
- [Task execution](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/execution/src/runtime.ts): `packages/execution/src/runtime.ts`
- [Model providers](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/providers/src/models/router.ts): `packages/providers/src/models/router.ts`
- [Output contract](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/output-format/src/process.ts): `packages/output-format/src/process.ts`

### Context and extensions

- [Screen verification](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/watch/src/service.ts): `packages/watch/src/service.ts`
- [Browser automation](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/browser/src/service.ts): `packages/browser/src/service.ts`
- [Research control plane](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/research/src/service.ts): `packages/research/src/service.ts`
- [Research worker](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/research-worker/src/worker.ts): `packages/research-worker/src/worker.ts`
- [Memory service](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/memory/src/index.ts): `packages/memory/src/index.ts`
- [Skills and conventions](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/skills/src/discovery.ts): `packages/skills/src/discovery.ts`
- [Knowledge graph](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/knowledge-graph/src/service.ts): `packages/knowledge-graph/src/service.ts`
- [Browser worker](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/browser-worker/src/engine.ts): `packages/browser-worker/src/engine.ts`

### Team collaboration

- [Team service](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/team/src/server.ts): `packages/team/src/server.ts`
- [Team chat](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/team-chat/src/service.ts): `packages/team-chat/src/service.ts`

### Learning and evaluation

- [Verified datasets](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/datasets/src/builder.ts): `packages/datasets/src/builder.ts`
- [Model training](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/training/src/service.ts): `packages/training/src/service.ts`
- [Specialist routing](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/specialists/src/task-routing.ts): `packages/specialists/src/task-routing.ts`
- [vLLM serving](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/providers-vllm/src/provider.ts): `packages/providers-vllm/src/provider.ts`
- [Independent evaluation](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/evaluation/src/service.ts): `packages/evaluation/src/service.ts`
- [Prompt optimization](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/optimization/src/service.ts): `packages/optimization/src/service.ts`
- [Workflow evolution](https://github.com/tanaypatel917-lab/mars-send-youre-ai-to-space/blob/main/packages/evolution/src/service.ts): `packages/evolution/src/service.ts`

### Other components

- **User**

## Connections

- User → CLI: starts commands (evidence: `README.md`)
- User → VS Code client: submits tasks (evidence: `README.md`)
- CLI → Workbench service: starts service
- VS Code client → Workbench service: connects by RPC (evidence: `README.md`)
- Workbench service → Isolated workspaces: isolates task copies (evidence: `README.md`)
- Workbench service → Task execution: runs tasks (evidence: `README.md`)
- Task execution → Model providers: requests model work (evidence: `README.md`)
- Task execution → Output contract: validates responses (evidence: `README.md`)
- Workbench service → Memory service: loads context (evidence: `README.md`)
- Workbench service → Skills and conventions: loads conventions (evidence: `README.md`)
- Workbench service → Research control plane: starts research (evidence: `README.md`)
- Research worker → Research control plane: reports findings (evidence: `README.md`)
- Workbench service → Screen verification: records verification (evidence: `README.md`)
- Browser worker → Browser automation: provides browser engine (evidence: `packages/browser-worker/src/engine.ts`)
- Workbench service → Browser automation: offers browser tasks
- Workbench service → Knowledge graph: builds repository context
- User → Team service: collaborates (evidence: `README.md`)
- Team chat → Team service: supports team chat
- Verified datasets → Model training: supplies training data (evidence: `README.md`)
- Model training → Specialist routing: produces adapters (evidence: `README.md`)
- Specialist routing → vLLM serving: routes to serving (evidence: `README.md`)
- Specialist routing → Independent evaluation: compares specialists (evidence: `README.md`)
- User → Independent evaluation: runs comparisons (evidence: `README.md`)
- User → Prompt optimization: optimizes prompts (evidence: `README.md`)
- User → Workflow evolution: proposes workflows
