https://github.com/matlab/terminal-in-matlab
Access system terminal from MATLAB
https://github.com/matlab/terminal-in-matlab
Last synced: about 1 month ago
JSON representation
Access system terminal from MATLAB
- Host: GitHub
- URL: https://github.com/matlab/terminal-in-matlab
- Owner: matlab
- License: other
- Created: 2026-05-27T08:18:34.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-09T16:38:46.000Z (about 1 month ago)
- Last Synced: 2026-06-14T07:35:45.845Z (about 1 month ago)
- Language: MATLAB
- Homepage:
- Size: 1.47 MB
- Stars: 22
- Watchers: 5
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Terminal in MATLAB
[](https://matlab.mathworks.com/open/github/v1?repo=matlab/terminal-in-matlab&file=toolbox/doc/Install.m) [](../../releases/latest/download/Terminal.mltbx) 
Run a terminal in MATLAB®. Use the terminal to run command-line interface tools such AI coding agents, `git`, and `docker` without leaving the MATLAB desktop.
## Table of Contents
- [Get Started](#get-started)
- [Set Up AI Agents](#set-up-ai-agents)
- [Use Terminal in Simulink](#use-terminal-in-simulink)
- [Additional Terminal Commands](#additional-terminal-commands)
- [Uninstall](#uninstall)
- [Licensing](#licensing)
- [Contact Support](#contact-support)
## Get Started
- You require MATLAB R2024b or later.
- Download [MATLAB Terminal (GitHub)](../../releases/latest/download/Terminal.mltbx) and install the toolbox in MATLAB:
```matlab
matlab.addons.install('Terminal.mltbx')
```
- Open a terminal in MATLAB:
```matlab
% Open a docked terminal
t = terminal();
```
### Set Up AI Agents
To use AI agents in the MATLAB terminal, you can use a wizard which sets up for you:
- an AI agent such as Claude Code, Gemini, or Amp.
- the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server)
- skills to help your AI agent use MATLAB and Simulink, from [MATLAB Agentic Toolkit (GitHub)](https://github.com/matlab/matlab-agentic-toolkit) and [Simulink Agentic Toolkit (GitHub)](https://github.com/matlab/simulink-agentic-toolkit)
Run the wizard:
```matlab
% Interactive wizard (first run)
t = terminal(Agentic=true);
```
You can also programmatically specify your agent and toolkits.
```
t = terminal(Agent="claude");
t = terminal(Agent="gemini", Toolkits=["matlab","simulink"]);
```
To change your options later on, run `terminal.resetAgentOptions` and re-run interactive wizard.
For more information about using the AI setup process, see [Using the Terminal AI Setup (GitHub)](/docs/terminal-ai-setup.md).
## Use Terminal in Simulink
Dock a terminal directly into the Simulink® editor as a right-side panel. This gives you command-line access alongside your model without switching windows.
```matlab
% Dock terminal in the most recently active Simulink editor
t = terminal(Place="simulink");
% Target a specific model by name
t = terminal(Model="myController");
% Customize the panel title
t = terminal(Place="simulink", Name="Build");
```
Requirements:
- Simulink must be installed and a model must be open before running the command.
- The terminal panel appears in the right dock of the Simulink editor.
## Additional Terminal Commands
You can use these additional commands with your terminal.
| Description | Command |
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
| Copy | `Ctrl` + `Shift` + `C` |
| Paste | `Ctrl` + `Shift` + `V` |
| Update terminal | terminal.update() |
| Uninstall terminal | matlab.addons.uninstall('Terminal') |
| Open with a custom title | `t = terminal(Name="Build");` |
| Open in a floating window | `t = terminal(WindowStyle="normal");` |
| Open with a specific shell | Linux/macOS: `t = terminal(Shell="zsh");`
Windows: `t = terminal(Shell="powershell.exe");` |
| Dock in Simulink editor | `t = terminal(Place="simulink");` |
| Dock in a specific model | `t = terminal(Model="myModel");` |
| Query where terminal is docked | `t.Place` |
| Customize terminal color theme | For instructions, see [Customize Terminal Theme (GitHub)](/docs/customize-terminal-theme.md) |
| List all running terminals | `terminal.list()` |
| Close all running terminals | `terminal.closeAll()` |
| Close a single terminal | `delete(t);` or `exit` |
| Query the shell in use | `t.Shell` |
| Check the installed version | `terminal.version()` |
## Uninstall
To remove Terminal and all artifacts it created:
```matlab
% 1. Uninstall the toolbox
matlab.addons.uninstall('Terminal')
% 2. Remove saved preferences
if ispref('terminal'), rmpref('terminal'); end
% 3. Remove downloaded agentic toolkits (if you used Agentic=true)
if ispc, home = getenv('USERPROFILE'); else, home = getenv('HOME'); end
rmdir(fullfile(home, '.matlab', 'agentic-toolkits'), 's')
```
## Licensing
The license is available in the [LICENSE.md](LICENSE.md) file in this GitHub repository.
## Contact Support
MathWorks encourages you to use this repository and provide feedback. To request technical support or submit an enhancement request, [create a GitHub issue](https://github.com/matlab/terminal-in-matlab/issues) or contact [MathWorks Technical Support](https://www.mathworks.com/support/contact_us.html).
---
Copyright 2026 The MathWorks, Inc.
---