All Terminal Commands | SIDRA OS Documentation

Install & Remove

Install SIDRA Stable on macOS or Windows, then remove the packaged runtime without deleting your projects or SIDRA state.

Install Stable

Choose the command for the computer you are using.

curl -fsSL https://install.sidra-ai.com/macos/install.sh | /bin/bash

Download and run the current macOS Stable installer.

macOS

irm https://install.sidra-ai.com/windows/install.ps1 | iex

Download and run the current Windows Stable installer from PowerShell.

Windows

sidra install

Initialize the packaged runtime. First-time customers should normally use the platform Stable installer above.

All

Remove the packaged runtime

The packaged uninstaller removes the installed runtime/service while preserving SIDRA state and project files by design.

bash "$HOME/Library/Application Support/SIDRA Agent OS/Versions/3.0.0/packaging/uninstall.sh"

Run the macOS 3.0.0 packaged uninstaller.

macOS

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\Programs\Soso\3.0.0\packaging\uninstall.ps1"

Run the Windows 3.0.0 packaged uninstaller.

Windows

Pair, inspect, repair, and manage Owner Control and protected outbound peers.

WhatsApp commands

Current user-facing WhatsApp CLI commands.

sidra whatsapp status

Show pairing and Owner Control status.

All

sidra whatsapp pair --owner <+international-number>

Pair the dedicated SIDRA WhatsApp account and register the Owner Control number.

All

sidra whatsapp repair --owner <+international-number>

Re-pair an existing installation while preserving and validating Owner Control.

All

sidra whatsapp owner <+international-number>

Set or replace the single Owner Control number.

All

sidra whatsapp inbox-status

Show protected Agent Inbox counts.

All

sidra whatsapp wake-off

Emergency-disable ChatGPT WhatsApp wake mode.

All

sidra whatsapp contacts [name]

Search saved WhatsApp contacts.

All

sidra whatsapp resolve <name-or-phone>

Resolve a saved contact name or phone to its WhatsApp JID.

All

sidra whatsapp peers [query]

List protected outbound WhatsApp peers.

All

sidra whatsapp peer-add <phone> --name <display> --alias <alias>

Add or update an outbound-only protected peer. --alias may be repeated.

All

sidra whatsapp peer-remove <peer>

Remove a protected peer by phone, JID, or unique exact alias.

All

SIDRA Brain

Set up, inspect, or move SIDRA Brain — the local Markdown-backed memory layer that keeps project truth with the work.

Brain commands

Use these when you need to inspect or explicitly bind the Brain vault.

sidra brain status

Show SIDRA Brain status and the active vault path.

All

sidra brain setup

Create or connect the default local SIDRA Brain vault.

All

sidra brain setup --path "<vault-path>"

Bind SIDRA Brain to a specific user-owned vault path.

All

Updates

Check the Stable channel first, apply the accepted release, then verify that SIDRA and its managed service are aligned.

Check for an update

Safe on both platforms. This compares the installed version and release SHA against Stable.

sidra update --check

Check Stable without downloading or changing runtime files.

All

Apply the update

Use the platform-specific path below.

sidra update

Download, stage, and schedule the accepted macOS Stable update.

macOS

irm https://install.sidra-ai.com/windows/install.ps1 | iex

Windows currently applies the accepted Stable release by rerunning the official Stable installer.

Windows

Verify after update

Confirm that no update remains and runtime/service state is healthy.

sidra update --check

Confirm Stable no longer reports an available update.

All

sidra status

Confirm runtime health, version, workspace, service alignment, and update readiness.

All

Runtime & Service

Inspect, start, stop, restart, diagnose, and manage the SIDRA runtime and its platform auto-start service.

Runtime

Everyday health and lifecycle commands.

sidra status

Show runtime health, version, workspace, tool count, service alignment, and update readiness.

All

sidra version

Show installed runtime version, build revision, schema, and tool count.

All

sidra doctor

Run the broader health check for runtime, service, update state, workspace, MCP, and schema.

All

sidra restart

Restart the SIDRA runtime server.

All

sidra start

Start the runtime server if it is stopped.

All

sidra stop

Stop the runtime server owned by the current SIDRA installation.

All

sidra help

Print the available SIDRA CLI commands.

All

Managed service

Use these when startup/service alignment is the problem rather than the runtime process itself.

sidra service status

Inspect the platform auto-start service or scheduled task.

All

sidra service restart

Restart the managed auto-start service.

All

sidra service install

Install or refresh the platform auto-start service.

All

sidra service stop

Stop the Windows managed startup task.

Windows

sidra service uninstall

Remove the Windows managed startup task while preserving runtime data.

Windows

Private MCP

Create, rotate, revoke, or reopen the private MCP connector URL used by supported AI clients.

Connector commands

Manage the private SIDRA connector without reinstalling the runtime.

sidra connect-mcp

Create or retrieve the stable private MCP connector URL and copy it to the clipboard.

All

sidra connect-mcp --rotate

Replace the private connector URL if it may have leaked.

All

sidra connect-mcp --revoke

Disable the current private connector URL immediately.

All

sidra connect-chatgpt

Backward-compatible alias for connect-mcp that also opens ChatGPT.

All

Workspace

Inspect, set, validate, clear, or revisit the project workspace SIDRA is currently operating inside.

Workspace commands

Keep SIDRA pointed at the correct project before asking it to act.

sidra workspace

Show the active workspace and detected project type.

All

sidra workspace set "<path>"

Set the active project workspace.

All

sidra workspace clear

Clear the workspace override and return to the default workspace.

All

sidra workspace recent

List recently used workspaces.

All

sidra workspace validate "<path>"

Validate that a workspace exists and is readable/writable.

All

sidra mode status

Show Developer / Full Power runtime mode and safety boundary status.

All

Computer Control

Install or repair the pinned CuaDriver prerequisite used by SIDRA native desktop control.

Install or repair CuaDriver

Choose the helper for your platform.

/bin/bash -c "$(curl -fsSL https://install.sidra-ai.com/macos/setup-cua.sh)"

Install or repair the pinned CuaDriver prerequisite on macOS.

macOS

irm https://install.sidra-ai.com/windows/setup-cua.ps1 | iex

Install or repair the pinned CuaDriver prerequisite on Windows.

Windows