Install Simplicity AI SDK for Codex on Linux#

Install and configure the Simplicity AI SDK for Codex in Visual Studio Code on Linux.

Prerequisites#

Before you begin, ensure that you have:

  • A supported version of Linux (AMD64 or x64)

  • Visual Studio Code with the Codex extension enabled

  • Access to the Simplicity AI SDK release that you are installing, such as Beta 1

Install the Silicon Labs Visual Studio Code Extension#

In Visual Studio Code, install the latest release of the Silicon Labs Visual Studio Code extension from the Extension Marketplace.

Download the Installer#

Download Simplicity Installer from the Simplicity Studio® website.

Run the Installer#

  1. Ensure the following system libraries are installed:

    sudo apt install libbz2-1.0=1.0.8-5.1
    sudo apt install bzip2
  2. In the file navigator, double-click the SimplicityInstaller executable from the archive.

Full Install#

  1. Select Full Install.

  2. Select Install.

  3. Wait for the installation to finish. The time required depends on your network speed.

  4. When the installation is complete, close the installer. You do not need to open Simplicity Studio.

Note: The installer downloads the Simplicity AI SDK tools and skills, copies the skills into the Visual Studio Code global skills location, automatically configures config.toml for Codex, and appends the newly downloaded tools.

Advanced Install#

  1. Select Advanced Install.

  2. Select Install.

  3. Wait for the installation to finish. The time required depends on your network speed.

  4. When the installation is complete, close the installer. You do not need to open Simplicity Studio.

Note: The installer downloads the Simplicity AI SDK tools and skills, copies the skills into the Visual Studio Code global skills location, automatically configures config.toml for Codex, and appends the newly downloaded tools.

Verify the Simplicity AI SDK Installation in Codex#

  1. Open Visual Studio Code.

  2. Open the Codex chat window by selecting the Toggle Chat or Toggle Secondary Sidebar icon.

    Toggle Chat and Toggle Secondary Sidebar icons in Visual Studio CodeToggle Chat and Toggle Secondary Sidebar icons in Visual Studio Code

  3. In the Codex chat window, select the gear icon, and then select Codex Settings.

    Codex Settings in the Codex chat windowCodex Settings in the Codex chat window

  4. Select MCP Servers and confirm that you see a list of Model Context Protocol (MCP) servers similar to those in the following image. Servers are usually enabled by default.

    Codex MCP Servers listCodex MCP Servers list

    Note: If these MCP servers are not listed, repeat the installation steps and confirm that you installed the MCP servers with Simplicity Installer.

Reference: Installer-Generated MCP Entries#

The installer writes the MCP server entries to ~/.codex/config.toml. Use the following sample to confirm your configuration or to restore an entry if automatic registration fails.

Copy only the MCP server tables into your current config.toml. Replace <RootPath> with your home directory, such as /home/<user>. Do not replace the entire file to avoid losing other Codex settings.

Codex config.toml MCP server entriesCodex config.toml MCP server entries

Codex config.toml MCP server entries continuedCodex config.toml MCP server entries continued

[mcp_servers.silabs-ai-sdk-helpers]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/ai_sdk_local_helpers/ai_sdk_local_helpers.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/ai_sdk_local_helpers"

[mcp_servers.silabs-build-tool]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/build_tool_mcp/build-tool-mcp/build_tool_server.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/build_tool_mcp/build-tool-mcp"

[mcp_servers.silabs-gdb-mcp]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/gdb_mcp/gdb-mcp/mcu_debug_tool.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/gdb_mcp/gdb-mcp"

[mcp_servers.silabs-knowledge-base]
url = "https://mcp.silabs.com/mcp"

[mcp_servers.silabs-knowledge-base.http_headers]
Authorization = "Bearer <token>"

[mcp_servers.silabs-tool-locator]
command = "<RootPath>/.silabs/slt/installs/archive/tool-locator-mcp/tool-locator-mcp"
cwd = "<RootPath>/.silabs/slt/installs/archive/tool-locator-mcp"

Note: The bundled Python version can change between releases. In ~/.silabs/slt/installs/archive, find the installed python-v<version> folder and use its name in the command paths.

Post-Installation Smoke Test#

Confirm that the Simplicity SDK is installed and that the Codex agent can detect it.

  1. After all MCP servers are enabled, enter the following in agent chat:

    What SiSDK version do I have installed?
  2. Confirm that the response is similar to the following:

    Simplicity SDK: version 2026.6.1

Select Your Language Model#

Select your preferred large language model (LLM) in the chat interface.

Note: Do not use automatic model selection. Manually selecting an LLM typically provides better performance and more consistent results. Choose a capable model with a sufficient context window for the task.

Troubleshooting#

  • Verify that Simplicity SDK 2026.6.1 is installed with Simplicity Installer.

  • If the chat session does not use MCP tools, confirm that Codex is in Agent mode.

  • If automatic registration fails, add the missing entries from Reference: Installer-Generated MCP Entries to ~/.codex/config.toml.

Related Topics#