Supermemory Harness

The ultimate Supermemory Local experience.

Core Flow

Commanded workflows from install to handoff.

Harness exposes each critical step as an explicit command: installation, Local startup, command-center access, recall verification, trust checks, and agent gating.

smctl install

Activates Harness, checks Local, installs bridge files, initializes project scope, and prints the next safe command.

smctl supermemory start

Starts Supermemory Local with Harness health events in the same terminal, including duplicate-port detection.

smctl ui

Opens a local proxy that keeps the Supermemory dashboard visible and adds the Harness command center.

smctl verify --timeout-ms 60000

Writes a harmless marker, waits for processing, searches it back, and confirms scoped recall.

smctl trust --probe

Runs an opt-in live check before a user or agent relies on memory for real work.

smctl gate

Returns pass, warn, or block before risky edits, tests, migration, dependency changes, or handoff.

Feature Systems

Operational systems for reliable local memory.

Harness adds proof, review, repair, personalization, dashboards, agent gates, and redacted evidence around Supermemory Local so memory-backed work remains auditable.

health scope recall gate verdict
Trust Layer

Pre-action trust checks

trust, gate, and session evaluate scope, health, warnings, and recall before agents perform high-impact work.

smctl trustsmctl gatesmctl session pre-action
write inbox approve reject local
Write Review

Reviewed write intake

guard places risky writes in a review inbox, applies project metadata, and forwards only approved memories to Local.

smctl guard inboxapprovereject
genome model profile gaps policy
Personalization

Personalization analysis

genome classifies stored memory, identifies personalization gaps, and can install a local policy for future writes.

smctl genomesmctl genome apply
issue diagnose steps verify
Recovery

Guided recovery

repair wizard converts failed writes, stale queues, retry loops, and recall mismatches into ordered recovery steps.

smctl repair wizardsmctl support
audit events redact proof launch
Proof

Redacted evidence board

evidence, advisor, recommend, and launch produce proof, readiness, and demo guidance.

smctl evidencesmctl launch
local proxy ui watch score
Operations

Runtime operations view

ui, watch, status, and score make Local state observable without manual log inspection.

smctl uismctl watchsmctl score
Cloud Migrator

Reviewed Local-to-Cloud migration, with receipts.

Harness treats Local as a serious staging ground. It reviews what can move, holds back risky or low-quality memory, uploads only when asked, then verifies and records what happened.

Local
Supermemory Local Documents, project tags, source anchors, timestamps, content hashes, and useful local knowledge.
Plan migrate plan finds migratable knowledge and keeps review data visible.
Review migrate review separates safe uploads from duplicates, failed docs, empty text, and secret-like content.
Redact --redact replaces detected sensitive material before proof or cloud movement.
Cloud
Supermemory Cloud migrate cloud --dry-run previews. --apply uploads through the Cloud document API only with explicit intent.
Audit
Verify and receipt migrate verify, receipt, and report show what moved and what still needs attention.

Boundary: this is reviewed knowledge migration, not a byte-perfect clone of Supermemory internals. Original database IDs, embeddings, chunk IDs, auth state, and Local-only processing state remain owned by Supermemory.

Command Inventory

Every command the CLI exposes.

The list is grouped by job so users can scan for the exact action they need without reading terminal output first.

Activation

  • smctl install
  • smctl enhance
  • smctl init
  • smctl project
  • smctl setup
  • smctl doctor

Readiness

  • smctl advisor
  • smctl evidence
  • smctl executive
  • smctl launch
  • smctl recommend
  • smctl workflow
  • smctl audit

Runtime

  • smctl start
  • smctl supermemory start
  • smctl ui
  • smctl watch
  • smctl status
  • smctl score
  • smctl timeline

Trust And Proof

  • smctl verify
  • smctl smoke
  • smctl trust
  • smctl trust --probe
  • smctl gate
  • smctl session pre-action
  • smctl session pre-compact
  • smctl session stop

Agent Bridge

  • smctl agent connect codex
  • smctl agent connect claude
  • smctl agent connect all
  • smctl agent status

Memory Quality

  • smctl memory doctor
  • smctl memory coach
  • smctl memory replay
  • smctl dreams
  • smctl cleanup
  • smctl repair
  • smctl repair wizard
  • smctl support
  • smctl backup

Personalization

  • smctl genome
  • smctl genome apply
  • smctl skillset list
  • smctl skillset install <name>
  • smctl skillset doctor
  • smctl skills list
  • smctl skills install
  • smctl skills doctor

Migration

  • smctl migrate doctor
  • smctl migrate plan
  • smctl migrate review
  • smctl migrate cloud
  • smctl migrate cloud --dry-run
  • smctl migrate cloud --apply
  • smctl migrate retry
  • smctl migrate verify
  • smctl migrate receipt
  • smctl migrate report

Guard

  • smctl guard start
  • smctl guard inbox
  • smctl guard approve <id>
  • smctl guard reject <id>

Hardware

  • smctl hardware init
  • smctl hardware ingest
  • smctl hardware observe
  • smctl hardware coach
  • smctl hardware replay

Optional Intelligence

  • smctl smart enable
  • smctl smart doctor
  • smctl smart ping
  • smctl smart disable
  • smctl brain doctor

Help

  • smctl help
  • smctl --help
  • smctl --version