Skip to content

Install Semwright

Connect your agent and try your first request in three steps.

Use the agent you already have. Semwright runs on your Linux, macOS or Windows computer and connects it to supported applications. Your agent needs MCP support to connect.

Open Terminal or PowerShell and paste the command for your system. It downloads the right package, checks it and runs setup.

Version 1.0.0. Independent security review is incomplete; see release status.

Linux
Terminal window
curl -fsSL https://semwright.com/install/v1.0.0.sh -o semwright-install.sh &&
bash semwright-install.sh

Run this as your regular user, without sudo.

macOS
Terminal window
curl -fsSL https://semwright.com/install/v1.0.0.sh -o semwright-install.sh &&
bash semwright-install.sh

Apple Silicon and Intel packages are selected automatically. These packages are unsigned and unnotarized. If macOS blocks execution, see If installation stops.

Windows

Open PowerShell as your regular user and paste the whole block:

Terminal window
& {
$semwrightInstaller = Join-Path $env:TEMP 'semwright-install.ps1'
Invoke-WebRequest -UseBasicParsing 'https://semwright.com/install/v1.0.0.ps1' -OutFile $semwrightInstaller -ErrorAction Stop
& $semwrightInstaller
}

x64 and ARM64 packages are selected automatically. If your computer blocks scripts, see If installation stops.

When installation finishes, find Next → 1. Broker in the terminal output. Copy that command, run it and leave that terminal open. This starts the local Semwright process that handles your agent’s requests.

Setup begins with read-only permissions. Editing an application requires the appropriate permissions and, where needed, your approval.

Setup creates a file called mcp-client.json containing the connection settings for your installation. Open a second terminal and display it using the command for your system:

Linux
Terminal window
cat "${XDG_CONFIG_HOME:-$HOME/.config}/semwright/mcp-client.json"
macOS
Terminal window
cat "$HOME/Library/Application Support/Semwright/config/mcp-client.json"
Windows
Terminal window
Get-Content "$env:APPDATA\Semwright\config\mcp-client.json"

In your agent’s MCP settings, add a local server:

  • Name: semwright
  • Connection: local / stdio
  • Command: the value of command in the file above
  • Arguments: leave empty

In Codex, open Settings → MCP servers → Add server, save the entry and restart. In the IDE extension, use the gear menu’s MCP servers screen. See OpenAI’s MCP instructions. If you use Codex CLI, the connection guide has ready-to-copy commands.

If your agent uses a JSON configuration file instead, merge the generated semwright entry into its existing mcpServers section. Keep your other servers. The connection guide explains the format.

Restart or reconnect your agent so it loads the new tools. Keep the Semwright terminal running.

Send this to your agent:

Use Semwright to list the capabilities available in this session. Explain what I can try next. Do not modify any files or applications.

The agent should call Semwright and report what is available in your environment. This checks the connection; application workflows need their own integrations and permissions.

Next, choose the application you want to use and follow its integration guide. To understand the creative workflow first, watch the Blender → Motion Canvas → MLT demo.

What you see What to do
Download failed Check your connection and run the install command again.
Integrity check failed Run the command again. The installer stops before extracting or installing that download.
Already installed Run semwright setup using the installed path in the message, then continue at step 2. For a new version, follow the upgrade instructions below.
curl is missing Install it with your system’s package manager, or use the manual download below.
macOS blocks the app Review the unsigned-package status. Follow your Mac’s normal approval process if you trust the download. On a managed computer, ask its administrator.
PowerShell blocks scripts Follow your organization’s script policy or ask its administrator. A manual download does not bypass that policy.
Your agent cannot connect Confirm that the Broker command is still running, check the command path in your agent’s settings and reconnect the agent. Run the Doctor command printed by setup for diagnostics.

For application-specific errors, continue with troubleshooting.

Download packages and inspect the installer

The commands above download a helper before running it. You can read the Linux / macOS installer or Windows installer first.

For manual installation, download your package and SHA256SUMS from the 1.0.0 release. Compare the archive’s SHA-256 with its entry in SHA256SUMS before extracting it.

Computer Package
Linux x64 semwright-1.0.0-x86_64.tar.gz
Linux ARM64 semwright-1.0.0-aarch64.tar.gz
Mac with Apple Silicon semwright-1.0.0-macos-arm64.tar.gz
Mac with Intel semwright-1.0.0-macos-x86_64.tar.gz
Windows x64 semwright-1.0.0-windows-x86_64.zip
Windows ARM64 semwright-1.0.0-windows-arm64.zip

After extraction, run ./install.sh on Linux or macOS, or .\Install-Semwright.ps1 in PowerShell on Windows. Then run the exact semwright setup command printed by the helper and continue at step 1 above to start Semwright.

Linux .deb alternatives are also available on the release page. Contributors can build from source.

The helper verifies the archive against the checksum pinned in this website’s release record and delegates installation to the package’s own installer. Matching checksums establish matching bytes; they do not establish publisher trust or a completed security review. Installation preserves the runtime’s existing permissions and approval process.

The bundle contains the CLI, local broker, MCP connection, terminal inspector and platform isolation helper. Models, third-party applications and optional integrations are installed separately. Setup preserves existing configuration and generates connection settings; it does not configure your agent automatically.

Stop the running Semwright process first. Use the uninstaller included with your package, then run the install command for the new version. Existing user configuration is preserved.

Use uninstall.sh from the installed folder on Linux or macOS, or Uninstall-Semwright.ps1 on Windows. Removal checks its recorded files and keeps user configuration and project data. If a file has changed, follow the reported error instead of deleting the installation folder manually.

Source: installation, quick start and setup implementation. The website helper wraps the published 1.0.0 bundles; it is not a new runtime release.