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

# sovseal CLI

> The sovseal command-line interface — 1-shot setup with zero-knowledge local memory, auto-provisioning, mind digests, and automated health checks.

The `@sovseal/mcp-server` package ships the `sovseal` CLI alongside the stdio MCP server. The local tier requires no account: storing and recalling memories run 100% on-device with zero browser logins, zero emails, and zero API key setup required.

## 1-Shot Setup Command

Autonomously provision your local project, configure zero-knowledge memory, and verify system health in a single terminal command:

```bash theme={null}
npx -y --package=@sovseal/mcp-server sovseal onboard
```

Or connect your AI coding tools (Claude Code, Cursor, Windsurf, Claude Desktop, Antigravity) with automatic tool registration:

```bash theme={null}
npx @sovseal/mcp-server connect
```

## Quick Start Commands

Run `sovseal` commands directly via `npx` (or install globally with `npm install -g @sovseal/mcp-server`):

<CodeGroup>
  ```bash Store Memory theme={null}
  # Store a memory item locally
  sovseal store "We standardized on Vitest for unit testing"
  ```

  ```bash Recall Memory theme={null}
  # Semantic search across local vault (0 RTT)
  sovseal recall "testing framework"
  ```

  ```bash Mind Digest theme={null}
  # Token-budgeted memory summary for session start
  sovseal mind
  ```

  ```bash Health Probes theme={null}
  # Run 9 health probes to verify local engine health
  sovseal doctor
  ```
</CodeGroup>

## `onboard` — 1-Shot Project Registration

Registers your local project with the managed edge so background replication can begin. Local capture and recall work with zero configuration whether or not you onboard.

```bash theme={null}
npx -y --package=@sovseal/mcp-server sovseal onboard
```

## `mind` — Agent Mind Digest

Prints a token-budgeted digest of the local store and exits without starting the embedding pipeline — fast enough to run at session start:

* **Core Mind State**: Procedural and semantic memories ranked by composite recall score.
* **Recurring Patterns**: Memories that have been reinforced more than once (`reinforce_count > 1`).

```bash theme={null}
sovseal mind
```

The same digest is available to agents at session start through the `sovseal://context/briefing` MCP resource.

## Agent Envelope Mode (`--json`)

Pass `--json` (alias `--agent`) to any command for clean, structured JSON envelopes formatted for AI tool loops:

```bash theme={null}
sovseal --json recall "architecture choices"
```