> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4minds.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 4Minds Symi CLI

> Install the 4Minds Symi CLI on macOS, Linux, or Windows, link it to your 4Minds account, and work with SYMI in a folder on your computer from your terminal.

The 4Minds Symi CLI runs SYMI in your terminal, on your own computer. It works on the files in the folder where you start it. Your sessions, memory, settings, and logs stay on your computer. SYMI runs on SYMI's default model. Each reply is generated by that model, and web searches go through your linked 4Minds account, so the CLI needs an internet connection.

> [!NOTE]
>
> To work with the files on your own computer, use the 4Minds Symi CLI. You install it once and start it with `symi`.

## Before you begin

| Computer | Requirement |
| - | - |
| macOS | Apple Silicon, macOS 13.5 or later |
| Linux | x64, glibc 2.28 or later (Alpine Linux is not supported) |
| Windows | x64, Windows 10 (version 1809 or later) or Windows 11, Windows PowerShell 5.1 or later |
| Windows with WSL | Use the Linux command inside WSL 2 |

* Sign in to SYMI in your browser. You need it to approve the link.
* You don't need Node.js, npm, pnpm, Git, Homebrew, or administrator rights.
* On Linux, `curl`, `tar`, `gzip`, and `ps` must be available. Minimal Linux images may need the `procps` and `ca-certificates` packages.

## Install and link

**1. Open the installer in SYMI**

In SYMI, select **Features**, then **Symi CLI**. The panel has two parts: **Commands** and **Install**.

**2. Choose your system**

In the list beside **Install**, select **macOS or Linux**, **Windows (PowerShell)**, or **Windows (WSL)**. SYMI preselects the option that matches your browser.

**3. Copy and run the command**

Select the copy button next to the command. Paste it into Terminal (macOS, Linux, WSL) or PowerShell (Windows) and press Enter. The command installs or updates the CLI, opens the account approval page, and starts the CLI after linking.

**4. Approve the link in your browser**

Your browser opens **Link 4Minds Symi CLI**. If it doesn't open, use the address the terminal prints. Sign in to SYMI if asked. Confirm that the **Check code** matches the one in your terminal, then select **Create link code**.

**5. Enter the code**

Type the code at the `Link code:` prompt and press Enter. The code works once and expires after a short time. If it expires, select **Create a new code**.

When linking succeeds, the CLI prints `Linked this installation to <your email>` and the date the link expires. A link lasts 90 days. SYMI then opens in your terminal. When the link expires, run `symi link` again.

![The Symi CLI panel, with its Commands and Install parts](https://mintcdn.com/4minds-e9525117/mqsBS4oUYgZTCqI2/images/Screenshot-2026-11-18-at-5.47.01-PM.png?fit=max\&auto=format\&n=mqsBS4oUYgZTCqI2\&q=85\&s=901f6d5fe29740a7110f34e3022a5f13)

> [!TIP]
>
> The command in the panel is for the current release. Copy it from SYMI each time you install or update.

The installer installs for your user only, in `~/.fourminds-symi-cli` (Windows: `%USERPROFILE%\.fourminds-symi-cli`), and adds `symi` to your path. Open a new terminal window if the command isn't found.

## Start the CLI

Open a terminal in the folder you want to work in and run:

```bash theme={null}
symi
```

The older command `fourminds-symi` still works. If another program on your computer already uses the name `symi`, the installer leaves it alone, and you start the CLI with `fourminds-symi`. A version from before November 18, 2026 has only `fourminds-symi` until you update.

The folder where you start the CLI is your workspace. To use another folder or reopen a session:

```bash theme={null}
symi --cwd /path/to/folder
symi --session <session-id>
```

Your terminal window must be at least 40 columns by 12 rows. SYMI can ask for your approval before it acts. Press `y` to allow once or `n` to reject.

## Commands

Type `/` to see the list. Use the arrow keys to choose, **Enter** to run, **Tab** to complete, **Esc** to close.

| Command | What it does |
| - | - |
| `/session` | Open or switch conversations |
| `/older` | Load older history for this conversation |
| `/copy` | Optionally freeze the transcript for plain-drag selection. Press `q` to return |
| `/exit` | Exit this CLI while leaving it running in the background |
| `/attach` | Attach a local document or image to the next message |
| `/workspace` | Select or register a local workspace |
| `/work` | Open conversations, teammates, and background jobs |
| `/files` | Open files generated in this conversation |
| `/plugins` | Inspect and configure installed plugins |
| `/setup` | Inspect or configure model providers |
| `/desktop` | Inspect, set up, start, or stop Desktop control |
| `/export` | Explain browser-only session export |
| `/effort` | Select the reasoning effort: High (default) or Max |
| `/presets` | Select an agent preset |
| `/skills` | Insert a skill into the composer |
| `/tools` | Inspect tools from the last model request |

> [!NOTE]
>
> The CLI uses one model, SYMI's default model. Use `/effort` to choose High or Max.

## What SYMI can do in the CLI

SYMI works with the files in your folder. It can read and edit files, run commands, and search the web. It can also create Word, Excel, and PowerPoint files. Type `/tools` to see the tools available in your session. Type `/skills` to insert a skill into your message.

When you ask SYMI to search the web, the search goes through your linked 4Minds account. If you aren't linked, SYMI doesn't search.

### Sub-agents

SYMI can hand parts of a task to helper agents. Type `/work` or press Ctrl+W to see your conversations, the helper agents, and background jobs. When you stop a reply, SYMI also stops its helper agents and background commands.

### Reminders

Ask SYMI in the terminal to remind you later, for example "remind me in 2 hours to check the build". Reminders belong to the current session and return to it as a new message when they are due.

* You can set a delay, an exact date and time with a time zone, or a repeating interval.
* Reminders do not use cron expressions.
* SYMI delivers a reminder while the SYMI background service is running on your computer, even if you closed the terminal. Reminders do not send email or chat messages.
* If several intervals were missed, SYMI delivers only the latest one.

## Keys

| Keys | Action |
| - | - |
| Enter | Send. While SYMI is working, queue or steer your message |
| Ctrl+S | While SYMI is working, use the other of queue or steer |
| Ctrl+J | New line |
| Ctrl+T | Attach a document |
| Ctrl+W | Open conversations, teammates, and background jobs |
| Esc or Ctrl+C | Stop a running reply. Messages you queued are kept, and the next one is sent |
| Ctrl+D | Cancel and exit |
| Ctrl+L | Jump to the latest output |

## How the CLI differs from SYMI on the web

* The CLI uses SYMI's default model. It does not use your 4Minds models. Reasoning is High or Max. The context window is up to about 524K tokens.
* Work happens in a folder on your computer. Sessions stay on your computer. Memory is on by default and stays on your computer.
* Connections (Outlook, HubSpot, and Slack) are available in SYMI on the web only.
* The CLI has its own commands. The web commands `/help`, `/status`, `/stop`, `/reset`, `/new`, and `/model` are not available in it.

## Manage your account link

```bash theme={null}
symi link status
symi link
symi unlink
```

* `link status` shows the linked account and when the link expires.
* `link` links again after a link expires or is revoked. You don't need to reinstall.
* `unlink` revokes the link on 4Minds and removes it from this computer.
* `unlink --no-revoke` removes the link from this computer without contacting 4Minds. The key stays valid until it expires or an account admin revokes it on the **API Keys** page.

If you run `link` through a different 4Minds address while already linked, the CLI asks whether to unlink and link again.

An account admin can also revoke a link on the **API Keys** page (in 4Minds, open **Settings** > **Security** and select **Manage API Keys**). The key name starts with **Symi CLI** and ends with your computer's name. Links made before November 12, 2026 start with **FourMinds Symi CLI**. If you are not an account admin, run `symi unlink` instead.

## Update

Close open CLI sessions. Then run the command from **Features** > **Symi CLI** again. A version from before November 13, 2026 can't search the web until you update. Your data and account link are kept. If a message asks you to run a command again, it prints the whole command for you to paste.

## Uninstall

Use the address in the command you copied from the panel: the part before `/install.sh` or `/install.ps1`. Run it with the uninstall option.

macOS, Linux, or WSL:

```bash theme={null}
curl -fsSL <installer address from the panel>/install.sh | bash -s -- --uninstall
```

Windows PowerShell:

```powershell theme={null}
& ([scriptblock]::Create((irm '<installer address from the panel>/install.ps1'))) -Uninstall
```

This removes the program and keeps your sessions, memory, settings, and account link. To revoke the link and delete all data, add `--purge` (`-Purge` on Windows). In a terminal you type `purge` to confirm. In a script, add `--yes` (`-Yes` on Windows).

> [!WARNING]
>
> Purging deletes all 4Minds Symi CLI data on this computer, including sessions and memory. You can't undo it.

## Troubleshoot

| Message or symptom | What to do |
| - | - |
| `macOS 13.5 or later is required.` or `Windows 10 version 1809 or later is required.` | Use a supported system. See **Before you begin**. |
| `No Symi CLI <version> release exists for ...` | Your computer type isn't supported, for example an Intel Mac. |
| `Required command is unavailable: ps` | On Debian or Ubuntu, run `apt-get install procps`, then try again. |
| `symi: command not found` | Open a new terminal window. If the command still isn't found, use `fourminds-symi`. |
| `An unrelated command already exists at ...` | Rename or remove that file, then run the installer again. |
| `Symi CLI sessions are running. Nothing was changed.` | Exit every CLI window with `/exit`, then run the command the installer prints. |
| `The active installation ... is incomplete or damaged.` | Run the command the installer prints. Your data is kept. |
| `That code has expired` or `That code was already used` | Run the command printed below the message, or `symi link`, and create a new code. |
| `This installation's 4Minds link has expired.` or `...was revoked.` | Run `symi link`. A link lasts 90 days. |
| `This installation's account link was not accepted.` | Run `symi link status`. If it shows linked, run `symi host restart`. If not, run `symi link`. |
| `The 4Minds account service is unavailable. Try again shortly.` | Wait and send your message again. |
| `This Symi CLI is not linked to a 4Minds account. Run: symi link` | Run `symi link`, enter the code, then run `symi` again. |
| `The 4Minds account link is no longer valid; run symi link again` | Run `symi link`. |
| `Too many searches for this account; wait a minute.` | Wait a minute, then ask again. |
| `Resize the terminal to at least 40 columns and 12 rows.` | Make the terminal window larger. |
| `The installer has not been activated on this server yet.` | Ask your administrator. The CLI isn't available on this server yet. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.