Getting started

This page shows developers how to install sMind by Spacing Mind (the CLI, the desktop app or the mobile app), start the daemon, and run a first task in a new workspace.

sMind by Spacing Mind, version 0.17.0. This page describes the 0.17.0 release.

smind is a daemon with a web UI and a command line. This page installs it, starts the daemon, and runs a first task.

Install the CLI

On Linux or macOS:

curl -fsSL https://spacingmind.com/install.sh | sh

The script downloads the latest release for your OS and architecture, checks it against checksums.txt, and installs smind to /usr/local/bin. If that directory is not writable it uses ~/.local/bin.

Options and environment variables:

Option	Effect
--version <v>	Install a specific release, for example --version 0.11.1.
SMIND_VERSION	Same as --version. The flag wins if both are set.
SMIND_INSTALL_DIR	Install into this directory.
--service	After installing, run smind service install (a systemd user unit on Linux, a LaunchAgent on macOS).
--system	With --service on Linux, install a system unit. Run the script with sudo.

curl -fsSL https://spacingmind.com/install.sh | sh -s -- --version 0.11.1

Run the script again to update. You can also update an installed binary with smind update.

On Windows, in PowerShell 5.1 or 7:

irm https://raw.githubusercontent.com/spacingmind/smind/master/scripts/install.ps1 | iex

The script installs smind.exe to %LOCALAPPDATA%\Programs\smind and adds that directory to your user PATH. Open a new terminal afterwards. It checks the SHA-256 of the download, honours SMIND_VERSION and SMIND_INSTALL_DIR, and leaves a previous install untouched if anything fails. Git for Windows is required. To also run the daemon at every logon, set SMIND_SERVICE=1 before the command.

From source, with Go installed:

go install github.com/spacingmind/smind/cmd/smind@latest

Install the desktop app

The desktop app bundles the matching smind daemon and starts it for you. Each release carries the installers.

macOS

Each release has one .dmg per architecture: smind-desktop-<version>-macos-arm64.dmg for Apple Silicon and smind-desktop-<version>-macos-x86_64.dmg for Intel. It needs macOS 13 or newer.

The app is not notarized yet. A copy downloaded in a browser is quarantined, so Gatekeeper blocks it or warns that it cannot be verified. That is expected. Do one of these:

• Drag sMind.app to /Applications, then right-click it, choose Open, and confirm Open in the dialog.

• Clear the quarantine flag once from Terminal:

  xattr -dr com.apple.quarantine /Applications/sMind.app

Or install with the script. It downloads with curl, which sets no quarantine flag:

curl -fsSL https://spacingmind.com/install.sh | sh -s -- --desktop

The script puts sMind.app in /Applications, or in ~/Applications if that is not writable. SMIND_APP_DIR picks another folder. Quit sMind first: the script refuses to replace a running app and never closes it.

Quitting the app leaves the daemon running. Reopen the app to reconnect.

Windows

Each release has an x64 installer, as a *-setup.exe and as a .msi. The installer bundles smind.exe. Install or Update in the app copies it to %LOCALAPPDATA%\smind\bin\ and runs it from there. Git for Windows is required.

The app installs separately from the command-line install above. Both can exist at once.

Install the mobile app

The repository does not document an app store listing. The app lives in the mobile/ directory and you build it yourself:

cd mobile
npm ci
npx expo run:ios      # or: npx expo run:android

Expo Go cannot run it; use a development build. After it is installed, pair the phone with your daemon through a relay. See Mobile and relay pairing.

Start the daemon

smind serve

The daemon listens on http://127.0.0.1:4648 by default. Open http://localhost:4648 in a browser for the web UI. The desktop app starts a daemon for you, so skip this step there.

To keep the daemon running across logouts and reboots, run smind service install. Check on it with smind status. To change the port, see Configuration.

Before you can run agents, log in to a provider. See Providers.

Create your first workspace

A workspace is an existing git repository. Tasks are created as worktrees branched off it.

From the command line:

smind workspace create /path/to/repo "my project" hard
smind workspace ls

The path must be absolute. ls prints each workspace's ID, which you need for the next step.

In the web UI, open the New workspace dialog from the sidebar, enter the repository path (or use Browse…), optionally a title, and choose Create workspace.

Create your first task

From the command line:

smind task new <workspaceId> "fix the failing test"
smind task send <taskId> glm "fix the failing test"

task new creates the task and its worktree. task send starts a run with the named provider and streams it. Press Ctrl+C to detach. The run keeps going. The provider id is one of claude-native, codex-native, glm or kimi.

In the web UI, use Add task in the workspace's menu in the sidebar, enter a title, and choose Create task. Then send a prompt from the task's chat.

For every command, see the CLI reference.