From a3b20763d4f929b71c66e38cc2543cf714d04b20 Mon Sep 17 00:00:00 2001
From: imilev <imilev@ethz.ch>
Date: Sun, 29 Jun 2025 00:33:31 +0300
Subject: [PATCH] Added high-level diagrams

---
 .codeboarding/Application_Management.md       |  93 ++++++
 .codeboarding/Computer_Interaction_Layer.md   | 277 ++++++++++++++++++
 .codeboarding/Interpreter_Core.md             | 131 +++++++++
 .../System_Tools_Language_Execution.md        | 103 +++++++
 .codeboarding/Terminal_User_Interface.md      | 199 +++++++++++++
 .codeboarding/on_boarding.md                  | 247 ++++++++++++++++
 6 files changed, 1050 insertions(+)
 create mode 100644 .codeboarding/Application_Management.md
 create mode 100644 .codeboarding/Computer_Interaction_Layer.md
 create mode 100644 .codeboarding/Interpreter_Core.md
 create mode 100644 .codeboarding/System_Tools_Language_Execution.md
 create mode 100644 .codeboarding/Terminal_User_Interface.md
 create mode 100644 .codeboarding/on_boarding.md

diff --git a/.codeboarding/Application_Management.md b/.codeboarding/Application_Management.md
new file mode 100644
index 0000000000..71e35dd7eb
--- /dev/null
+++ b/.codeboarding/Application_Management.md
@@ -0,0 +1,93 @@
+```mermaid
+
+graph LR
+
+    User_Profile_Manager["User Profile Manager"]
+
+    Conversation_Contribution_Manager["Conversation Contribution Manager"]
+
+    Application_Lifecycle_Manager["Application Lifecycle Manager"]
+
+    Application_Lifecycle_Manager -- "uses" --> User_Profile_Manager
+
+    Application_Lifecycle_Manager -- "uses" --> Conversation_Contribution_Manager
+
+    User_Profile_Manager -- "interacts with" --> File_System
+
+    Conversation_Contribution_Manager -- "interacts with" --> Telemetry_System
+
+    Conversation_Contribution_Manager -- "interacts with" --> File_System
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+Application Management subsystem
+
+
+
+### User Profile Manager
+
+This component is dedicated to managing user profiles, which store configuration settings, preferences, and other user-specific data. It provides functionalities to retrieve, apply, reset, and migrate user profiles, ensuring that the interpreter operates according to the user's personalized settings and maintains state across sessions.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/profiles/profiles.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.profiles.profiles` (1:1)</a>
+
+
+
+
+
+### Conversation Contribution Manager
+
+This component is responsible for managing the collection, storage, and submission of user conversation data. It handles the logic for retrieving past conversations, prompting the user for contribution consent, and writing conversation data to a cache. Its primary purpose is to facilitate the improvement of the interpreter by allowing users to share their interaction data for telemetry and model enhancement.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/contributing_conversations.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.contributing_conversations` (1:1)</a>
+
+
+
+
+
+### Application Lifecycle Manager
+
+This component orchestrates the overall startup and shutdown of the application's terminal interface. It handles initial setup tasks such as parsing command-line arguments, validating LLM settings, and coordinating with other core components like the User Profile Manager and Conversation Contribution Manager to initialize the application environment.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/start_terminal_interface.py#L18-L577" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.start_terminal_interface` (18:577)</a>
+
+
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file
diff --git a/.codeboarding/Computer_Interaction_Layer.md b/.codeboarding/Computer_Interaction_Layer.md
new file mode 100644
index 0000000000..8faf9c5351
--- /dev/null
+++ b/.codeboarding/Computer_Interaction_Layer.md
@@ -0,0 +1,277 @@
+```mermaid
+
+graph LR
+
+    Computer_Interaction_Layer["Computer Interaction Layer"]
+
+    AI_Tool["AI Tool"]
+
+    Browser_Tool["Browser Tool"]
+
+    Terminal_Tool["Terminal Tool"]
+
+    Files_Tool["Files Tool"]
+
+    Display_Tool["Display Tool"]
+
+    Keyboard_Tool["Keyboard Tool"]
+
+    Mouse_Tool["Mouse Tool"]
+
+    OS_Tool["OS Tool"]
+
+    Base_Language["Base Language"]
+
+    Interpreter_Core["Interpreter Core"]
+
+    Specific_Language_Implementations["Specific Language Implementations"]
+
+    Interpreter_Core -- "uses" --> Computer_Interaction_Layer
+
+    Computer_Interaction_Layer -- "is composed of" --> AI_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Browser_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Terminal_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Files_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Display_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Keyboard_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> Mouse_Tool
+
+    Computer_Interaction_Layer -- "is composed of" --> OS_Tool
+
+    Terminal_Tool -- "uses" --> Base_Language
+
+    Base_Language -- "is extended by" --> Specific_Language_Implementations
+
+    click Computer_Interaction_Layer href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Computer_Interaction_Layer.md" "Details"
+
+    click Interpreter_Core href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Interpreter_Core.md" "Details"
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+The Computer Interaction Layer is a critical subsystem within the project, designed to provide the Interpreter Core with a unified and high-level programmatic interface for interacting with the underlying computer system. It achieves this by aggregating and managing various specialized computer tools, thereby abstracting the complexities of direct system interaction. This design is fundamental as it isolates the core logic of the interpreter from the specifics of operating system interactions, enhancing portability, maintainability, and extensibility.
+
+
+
+### Computer Interaction Layer
+
+The primary component that acts as a central hub, providing a unified, high-level programmatic interface for the Interpreter Core to interact with the underlying computer system. It aggregates and manages various specialized computer tools, abstracting the complexities of direct system interaction (e.g., file system, browser, display, AI capabilities).
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Computer Interaction Layer` (1:1)
+
+
+
+
+
+### AI Tool
+
+Provides an interface for the interpreter to interact with AI capabilities, such as image recognition or natural language processing.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `AI Tool` (1:1)
+
+
+
+
+
+### Browser Tool
+
+Enables the interpreter to programmatically control and interact with a web browser for tasks like navigation, data extraction, or web application automation.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Browser Tool` (1:1)
+
+
+
+
+
+### Terminal Tool
+
+Provides an interface for executing commands in the system terminal and capturing their output, supporting various programming languages.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Terminal Tool` (1:1)
+
+
+
+
+
+### Files Tool
+
+Manages file system operations, including reading, writing, creating, and deleting files and directories.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Files Tool` (1:1)
+
+
+
+
+
+### Display Tool
+
+Manages interactions with the computer's display, potentially for screen capture, display settings, or rendering information.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Display Tool` (1:1)
+
+
+
+
+
+### Keyboard Tool
+
+Enables programmatic control of the keyboard for simulating key presses and input.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Keyboard Tool` (1:1)
+
+
+
+
+
+### Mouse Tool
+
+Enables programmatic control of the mouse for simulating movements and clicks.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Mouse Tool` (1:1)
+
+
+
+
+
+### OS Tool
+
+Provides an interface for interacting with the operating system, offering functionalities like system information retrieval, process management, and environment variable access.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `OS Tool` (1:1)
+
+
+
+
+
+### Base Language
+
+An abstract base class that defines the common interface and functionalities for all specific language implementations used by the Terminal Tool. This includes methods for executing code and handling output.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `Base Language` (1:1)
+
+
+
+
+
+### Interpreter Core
+
+The core logic of the interpreter that uses the Computer Interaction Layer.
+
+
+
+
+
+**Related Classes/Methods**: _None_
+
+
+
+### Specific Language Implementations
+
+Various specific language implementations (e.g., Python, JavaScript, Shell) that extend the Base Language.
+
+
+
+
+
+**Related Classes/Methods**: _None_
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file
diff --git a/.codeboarding/Interpreter_Core.md b/.codeboarding/Interpreter_Core.md
new file mode 100644
index 0000000000..441df75717
--- /dev/null
+++ b/.codeboarding/Interpreter_Core.md
@@ -0,0 +1,131 @@
+```mermaid
+
+graph LR
+
+    Interpreter_Core["Interpreter Core"]
+
+    LLM_Manager["LLM Manager"]
+
+    Computer_Interface["Computer Interface"]
+
+    Terminal_Execution_Engine["Terminal Execution Engine"]
+
+    Interpreter_Core -- "Orchestrates" --> LLM_Manager
+
+    LLM_Manager -- "Provides responses to" --> Interpreter_Core
+
+    Interpreter_Core -- "Delegates tasks to" --> Computer_Interface
+
+    Computer_Interface -- "Returns execution results to" --> Interpreter_Core
+
+    Computer_Interface -- "Delegates code execution to" --> Terminal_Execution_Engine
+
+    Terminal_Execution_Engine -- "Executes code for" --> Computer_Interface
+
+    click Interpreter_Core href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Interpreter_Core.md" "Details"
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+The `Interpreter Core` subsystem is the brain of the application, orchestrating the entire conversation flow, interacting with the Language Model (LLM), and managing computer-related tasks. It is designed with a clear separation of concerns, allowing for modularity and extensibility.
+
+
+
+### Interpreter Core
+
+This is the central processing unit of the application. It manages the overall conversation flow, interprets messages, decides on actions (LLM interaction or computer tasks), and orchestrates the execution of these actions. It also handles asynchronous operations and provides an API server for external interaction, acting as the primary coordinator.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/core.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.core.core.OpenInterpreter` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/async_core.py#L43-L275" target="_blank" rel="noopener noreferrer">`interpreter.core.async_core.AsyncInterpreter` (43:275)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/async_core.py#L950-L1018" target="_blank" rel="noopener noreferrer">`interpreter.core.async_core.Server` (950:1018)</a>
+
+
+
+
+
+### LLM Manager
+
+This component is solely responsible for all communication with the Language Model. It handles sending prompts, receiving responses, and abstracting away the complexities of different LLM providers and their specific APIs (e.g., function calling, text generation). It ensures the `Interpreter Core` remains agnostic to the underlying LLM implementation.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/llm/llm.py#L37-L412" target="_blank" rel="noopener noreferrer">`interpreter.core.llm.llm.Llm` (37:412)</a>
+
+
+
+
+
+### Computer Interface
+
+This component provides the LLM with the ability to interact with the computer's operating system and various applications. It acts as a unified interface for diverse computer functionalities, exposing a set of "tools" or "skills" that the LLM can call. It abstracts the complexities of system-level operations, such as file system access, browser control, or terminal commands.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/computer.py#L21-L236" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.computer.Computer` (21:236)</a>
+
+
+
+
+
+### Terminal Execution Engine
+
+This component, a specialized part of the `Computer Interface`, is responsible for executing code in various programming languages (e.g., Python, JavaScript, Shell) within the terminal environment. It manages the lifecycle of language processes, handles input/output, and provides the actual execution environment for code generated by the LLM.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/terminal.py#L32-L206" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.terminal.Terminal` (32:206)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/subprocess_language.py#L11-L192" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.subprocess_language.SubprocessLanguage` (11:192)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/python.py#L10-L12" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.python.Python` (10:12)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/shell.py#L7-L35" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.shell.Shell` (7:35)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/javascript.py#L5-L34" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.javascript.JavaScript` (5:34)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/jupyter_language.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.jupyter_language.JupyterLanguage` (1:1)</a>
+
+
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file
diff --git a/.codeboarding/System_Tools_Language_Execution.md b/.codeboarding/System_Tools_Language_Execution.md
new file mode 100644
index 0000000000..0afadc0818
--- /dev/null
+++ b/.codeboarding/System_Tools_Language_Execution.md
@@ -0,0 +1,103 @@
+```mermaid
+
+graph LR
+
+    System_Interaction_Tools["System Interaction Tools"]
+
+    Language_Execution_Engines["Language Execution Engines"]
+
+    System_Interaction_Tools -- "leverages" --> Language_Execution_Engines
+
+    Language_Execution_Engines -- "provides services to" --> System_Interaction_Tools
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+This component is a critical part of the interpreter's ability to interact with the host operating system and execute code in various programming languages. It is composed of two fundamental sub-components: `System Interaction Tools` and `Language Execution Engines`.
+
+
+
+### System Interaction Tools
+
+This component provides high-level, abstract interfaces for the interpreter to interact with the underlying computer system. It encapsulates functionalities such as executing shell commands, performing file system operations (like editing), and general computer control. These tools act as a crucial bridge, translating the interpreter's high-level directives into concrete, low-level system actions.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `BashTool` (1:1)
+
+- `ComputerTool` (1:1)
+
+- `EditTool` (1:1)
+
+- `BaseAnthropicTool` (1:1)
+
+- `ToolResult` (1:1)
+
+- `CLIResult` (1:1)
+
+- `ToolFailure` (1:1)
+
+
+
+
+
+### Language Execution Engines
+
+This component is responsible for managing the execution of code in various programming and scripting languages within the terminal environment. It provides a standardized and extensible framework for running code, capturing its output, and handling different language-specific execution paradigms (e.g., direct subprocess execution, Jupyter kernel interactions).
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/base_language.py#L1-L1" target="_blank" rel="noopener noreferrer">`BaseLanguage` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/subprocess_language.py#L11-L192" target="_blank" rel="noopener noreferrer">`SubprocessLanguage` (11:192)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/jupyter_language.py#L1-L1" target="_blank" rel="noopener noreferrer">`JupyterLanguage` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/shell.py#L7-L35" target="_blank" rel="noopener noreferrer">`Shell` (7:35)</a>
+
+- `PowerShell` (1:1)
+
+- `AppleScript` (1:1)
+
+- `JavaScript` (1:1)
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/java.py#L9-L125" target="_blank" rel="noopener noreferrer">`Java` (9:125)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/python.py#L10-L12" target="_blank" rel="noopener noreferrer">`Python` (10:12)</a>
+
+- `HTML` (1:1)
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/r.py#L5-L72" target="_blank" rel="noopener noreferrer">`R` (5:72)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/react.py#L42-L77" target="_blank" rel="noopener noreferrer">`React` (42:77)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/ruby.py#L5-L59" target="_blank" rel="noopener noreferrer">`Ruby` (5:59)</a>
+
+
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file
diff --git a/.codeboarding/Terminal_User_Interface.md b/.codeboarding/Terminal_User_Interface.md
new file mode 100644
index 0000000000..3f91944f9a
--- /dev/null
+++ b/.codeboarding/Terminal_User_Interface.md
@@ -0,0 +1,199 @@
+```mermaid
+
+graph LR
+
+    Terminal_Interface_Manager["Terminal Interface Manager"]
+
+    Magic_Commands_Handler["Magic Commands Handler"]
+
+    Output_Display_Utility["Output Display Utility"]
+
+    Terminal_Interface_Components["Terminal Interface Components"]
+
+    Conversation_Navigator["Conversation Navigator"]
+
+    Contributing_Conversations["Contributing Conversations"]
+
+    Validate_LLM_Settings["Validate LLM Settings"]
+
+    Core_Interpreter["Core Interpreter"]
+
+    Terminal_Interface_Manager -- "initializes and controls" --> Core_Interpreter
+
+    Core_Interpreter -- "sends output to" --> Terminal_Interface_Manager
+
+    Terminal_Interface_Manager -- "dispatches commands to" --> Magic_Commands_Handler
+
+    Terminal_Interface_Manager -- "delegates output rendering to" --> Output_Display_Utility
+
+    Terminal_Interface_Manager -- "interacts with" --> Conversation_Navigator
+
+    Terminal_Interface_Manager -- "interacts with" --> Contributing_Conversations
+
+    Terminal_Interface_Manager -- "invokes" --> Validate_LLM_Settings
+
+    Output_Display_Utility -- "utilizes" --> Terminal_Interface_Components
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+The Terminal User Interface subsystem is the user-facing layer of the application, responsible for all interactions within the command-line environment. It acts as the primary application entry point, displaying interpreter output, capturing user input, and providing a rich, formatted terminal experience.
+
+
+
+### Terminal Interface Manager
+
+This component is the central orchestrator and primary entry point for the terminal-based interaction. It initializes the interpreter, parses command-line arguments, manages the main interaction loop, and coordinates the lifecycle of the interpreter session. It acts as the hub, directing control and data flow between various terminal-related functionalities and the core interpreter. It is fundamental because it ties all other terminal components together, providing the main operational loop and overall control.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/start_terminal_interface.py#L18-L577" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.start_terminal_interface` (18:577)</a>
+
+
+
+
+
+### Magic Commands Handler
+
+This component is dedicated to processing special "magic" commands (e.g., /help, /jupyter, /markdown) entered by the user. It extends the interpreter's functionality beyond standard code execution, enabling features like displaying help documentation, managing Jupyter environments, or handling specific output formats. It is fundamental for enhancing user interaction by providing shortcuts and extended functionalities not directly related to code execution.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/magic_commands.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.magic_commands` (1:1)</a>
+
+
+
+
+
+### Output Display Utility
+
+This component standardizes and manages how various types of output from the interpreter (e.g., code, messages, file operations) are presented to the user in the command-line interface. It provides formatting and utility functions to ensure a consistent, readable, and visually appealing display. It is fundamental for a good user experience, ensuring that complex information is presented clearly and consistently.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/utils/display_output.py#L9-L33" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.utils.display_output` (9:33)</a>
+
+
+
+
+
+### Terminal Interface Components
+
+This component defines the fundamental building blocks and visual elements used for displaying structured content within the terminal interface. It includes base classes and specific implementations for different types of output blocks, such as BaseBlock, CodeBlock, and MessageBlock, ensuring consistent rendering and extensibility for UI elements. It is fundamental as it provides the reusable visual primitives upon which the entire terminal output is constructed.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `interpreter.terminal_interface.components` (1:1)
+
+
+
+
+
+### Conversation Navigator
+
+This component provides functionality for navigating and displaying past conversations within the terminal interface. It allows users to review previous interactions, which is crucial for context, debugging, and continuing work across sessions. It is fundamental for user productivity and maintaining context across interactions.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/conversation_navigator.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.conversation_navigator` (1:1)</a>
+
+
+
+
+
+### Contributing Conversations
+
+This component encapsulates the logic related to offering and managing the contribution of user conversations. This feature is likely used for improving the interpreter's capabilities or gathering data, and it integrates seamlessly with the main terminal interaction flow. It is fundamental for features that involve user data collection and system improvement.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/contributing_conversations.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.contributing_conversations` (1:1)</a>
+
+
+
+
+
+### Validate LLM Settings
+
+This component is responsible for validating and potentially configuring the Language Model (LLM) settings that the interpreter will use. It ensures that the necessary LLM configurations are correctly set up before the main interaction loop begins, which is a critical pre-flight check for the application's core functionality. It is fundamental for ensuring the core AI capabilities are correctly configured before operation.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/validate_llm_settings.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.validate_llm_settings` (1:1)</a>
+
+
+
+
+
+### Core Interpreter
+
+While not strictly part of the terminal_interface package, this is the central processing unit of the application. It is responsible for interpreting user input, executing code, and managing the overall conversational flow. The Terminal User Interface heavily relies on this component for actual interpretation and execution, acting as its primary input/output channel. It is fundamental as it represents the "brain" of the application, performing the actual interpretation and execution that the terminal interface facilitates.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/core.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.core.core` (1:1)</a>
+
+
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file
diff --git a/.codeboarding/on_boarding.md b/.codeboarding/on_boarding.md
new file mode 100644
index 0000000000..cafc7897a7
--- /dev/null
+++ b/.codeboarding/on_boarding.md
@@ -0,0 +1,247 @@
+```mermaid
+
+graph LR
+
+    Interpreter_Core["Interpreter Core"]
+
+    Computer_Interaction_Layer["Computer Interaction Layer"]
+
+    System_Tools_Language_Execution["System Tools & Language Execution"]
+
+    Terminal_User_Interface["Terminal User Interface"]
+
+    Application_Management["Application Management"]
+
+    Interpreter_Core -- "interacts with" --> Computer_Interaction_Layer
+
+    Interpreter_Core -- "communicates with" --> Terminal_User_Interface
+
+    Computer_Interaction_Layer -- "utilizes" --> System_Tools_Language_Execution
+
+    System_Tools_Language_Execution -- "provides capabilities to" --> Computer_Interaction_Layer
+
+    Terminal_User_Interface -- "sends input to" --> Interpreter_Core
+
+    Terminal_User_Interface -- "receives output from" --> Interpreter_Core
+
+    Application_Management -- "initializes" --> Interpreter_Core
+
+    Application_Management -- "configures" --> Terminal_User_Interface
+
+    click Interpreter_Core href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Interpreter_Core.md" "Details"
+
+    click Computer_Interaction_Layer href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Computer_Interaction_Layer.md" "Details"
+
+    click System_Tools_Language_Execution href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//System_Tools_Language_Execution.md" "Details"
+
+    click Terminal_User_Interface href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Terminal_User_Interface.md" "Details"
+
+    click Application_Management href "https://github.com/OpenInterpreter/open-interpreter/blob/main/.codeboarding//Application_Management.md" "Details"
+
+```
+
+[![CodeBoarding](https://img.shields.io/badge/Generated%20by-CodeBoarding-9cf?style=flat-square)](https://github.com/CodeBoarding/GeneratedOnBoardings)[![Demo](https://img.shields.io/badge/Try%20our-Demo-blue?style=flat-square)](https://www.codeboarding.org/demo)[![Contact](https://img.shields.io/badge/Contact%20us%20-%20contact@codeboarding.org-lightgrey?style=flat-square)](mailto:contact@codeboarding.org)
+
+
+
+## Component Details
+
+
+
+This analysis consolidates the Control Flow Graph (CFG) and Source Analysis into a high-level architectural overview, identifying five core components and their interactions.
+
+
+
+### Interpreter Core
+
+The central processing unit of the application. It manages the overall conversation flow, interacts with the Language Model (LLM) to generate responses and actions, and orchestrates the execution of computer-related tasks. It also handles asynchronous operations and provides an API server for external interaction.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/core.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.core.core.OpenInterpreter` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/async_core.py#L43-L275" target="_blank" rel="noopener noreferrer">`interpreter.core.async_core.AsyncInterpreter` (43:275)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/async_core.py#L950-L1018" target="_blank" rel="noopener noreferrer">`interpreter.core.async_core.Server` (950:1018)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/llm/llm.py#L37-L412" target="_blank" rel="noopener noreferrer">`interpreter.core.llm.llm.Llm` (37:412)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/llm/run_tool_calling_llm.py#L100-L314" target="_blank" rel="noopener noreferrer">`interpreter.core.llm.run_tool_calling_llm.run_tool_calling_llm` (100:314)</a>
+
+
+
+
+
+### Computer Interaction Layer
+
+Provides a unified, high-level programmatic interface for the `Interpreter Core` to interact with the underlying computer system. It aggregates and manages various specialized computer tools, abstracting the complexities of direct system interaction (e.g., file system, browser, display, AI capabilities).
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/computer.py#L21-L236" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.computer.Computer` (21:236)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/ai/ai.py#L115-L191" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.ai.ai.Ai` (115:191)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/browser/browser.py#L12-L160" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.browser.browser.Browser` (12:160)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/calendar/calendar.py#L22-L301" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.calendar.calendar.Calendar` (22:301)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/clipboard/clipboard.py#L6-L34" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.clipboard.clipboard.Clipboard` (6:34)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/contacts/contacts.py#L5-L91" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.contacts.contacts.Contacts` (5:91)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/display/display.py#L45-L338" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.display.display.Display` (45:338)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/docs/docs.py#L8-L24" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.docs.docs.Docs` (8:24)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/files/files.py#L7-L35" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.files.files.Files` (7:35)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/keyboard/keyboard.py#L10-L130" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.keyboard.keyboard.Keyboard` (10:130)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/mail/mail.py#L8-L160" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.mail.mail.Mail` (8:160)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/mouse/mouse.py#L19-L271" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.mouse.mouse.Mouse` (19:271)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/os/os.py#L4-L80" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.os.os.Os` (4:80)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/sms/sms.py#L9-L122" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.sms.sms.SMS` (9:122)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/terminal.py#L32-L206" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.terminal.Terminal` (32:206)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/vision/vision.py#L14-L174" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.vision.vision.Vision` (14:174)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/computer_use/loop.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.computer_use.loop.main` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/computer_use/loop.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.computer_use.loop.sampling_loop` (1:1)</a>
+
+
+
+
+
+### System Tools & Language Execution
+
+Implements concrete system interaction capabilities (e.g., executing shell commands, performing file edits) and manages the execution of code in various programming and scripting languages within the terminal environment. These are the low-level "workers" used by the `Computer Interaction Layer`.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- `interpreter.computer_use.tools.BashTool` (1:1)
+
+- `interpreter.computer_use.tools.ComputerTool` (1:1)
+
+- `interpreter.computer_use.tools.EditTool` (1:1)
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/jupyter_language.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.JupyterLanguage` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/shell.py#L7-L35" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.Shell` (7:35)</a>
+
+- `interpreter.core.computer.terminal.languages.PowerShell` (1:1)
+
+- `interpreter.core.computer.terminal.languages.AppleScript` (1:1)
+
+- `interpreter.core.computer.terminal.languages.JavaScript` (1:1)
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/java.py#L9-L125" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.Java` (9:125)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/subprocess_language.py#L11-L192" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.SubprocessLanguage` (11:192)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/python.py#L10-L12" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.Python` (10:12)</a>
+
+- `interpreter.core.computer.terminal.languages.HTML` (1:1)
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/r.py#L5-L72" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.R` (5:72)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/react.py#L42-L77" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.React` (42:77)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/core/computer/terminal/languages/ruby.py#L5-L59" target="_blank" rel="noopener noreferrer">`interpreter.core.computer.terminal.languages.Ruby` (5:59)</a>
+
+
+
+
+
+### Terminal User Interface
+
+Responsible for all user-facing interactions in the command-line environment. It displays interpreter output, captures user input, and provides formatting and utility functions for a rich terminal experience. It also serves as the primary application entry point.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/start_terminal_interface.py#L607-L660" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.start_terminal_interface.main` (607:660)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/start_terminal_interface.py#L18-L577" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.start_terminal_interface.start_terminal_interface` (18:577)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/components/base_block.py#L4-L23" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.components.BaseBlock` (4:23)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/components/code_block.py#L9-L97" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.components.CodeBlock` (9:97)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/components/message_block.py#L9-L27" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.components.MessageBlock` (9:27)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/utils/display_output.py#L9-L33" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.utils.display_output.display_output` (9:33)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/utils/display_output.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.utils.display_output.count_messages_tokens` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/utils/display_output.py#L1-L1" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.utils.display_output.export_to_markdown` (1:1)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/magic_commands.py#L145-L147" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.magic_commands.default_handle` (145:147)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/magic_commands.py#L258-L296" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.magic_commands.jupyter` (258:296)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/magic_commands.py#L299-L309" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.magic_commands.markdown` (299:309)</a>
+
+
+
+
+
+### Application Management
+
+Manages the application's startup, shutdown, and persistent settings. This includes parsing command-line arguments, handling user profiles (loading, saving, migration), and managing conversation telemetry.
+
+
+
+
+
+**Related Classes/Methods**:
+
+
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/contributing_conversations.py#L82-L92" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.contributing_conversations.contribute_conversation_launch_logic` (82:92)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/contributing_conversations.py#L40-L56" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.contributing_conversations.send_past_conversations` (40:56)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/profiles/profiles.py#L30-L63" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.profiles.profiles.profile` (30:63)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/profiles/profiles.py#L144-L212" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.profiles.profiles.apply_profile` (144:212)</a>
+
+- <a href="https://github.com/OpenInterpreter/open-interpreter/blob/master/interpreter/terminal_interface/profiles/profiles.py#L215-L558" target="_blank" rel="noopener noreferrer">`interpreter.terminal_interface.profiles.profiles.migrate_profile` (215:558)</a>
+
+
+
+
+
+
+
+
+
+### [FAQ](https://github.com/CodeBoarding/GeneratedOnBoardings/tree/main?tab=readme-ov-file#faq)
\ No newline at end of file