Skip to main content
All Vise actions can be driven by running command lines locally. Below is the complete list of CLI operations categorized by lifecycle stage.

Project Inspection & Planning

These commands help AI coding agents analyze your workspace, map requirements, and generate compliant setup roadmaps.

vise doctor

Verify your local Vise installation.
vise doctor
  • Description: Diagnostic health check that prints the active Vise version, node installation path, system details, and documentation endpoint state.

vise inspect

Inspect code workspace frameworks and platforms.
vise inspect [path]
  • Description: Scans the project directory (defaults to current path) to detect platforms (React, Flutter, Android, iOS), monorepo boundaries, package configurations, and existing compiler sensors.

vise plan

Generate a grounded compliance integration plan.
vise plan [path] --request "your prompt"
  • Description: Generates an implementation plan matching your request. Queries hosted documentation and returns intake parameters, required design tokens, and relevant SDK code snippets.

vise plan-harness

Pre-planning harness setup.
vise plan-harness [path] --request "your prompt"
  • Description: Generates the internal scaffolding and test mocks around the prompt before plan writing commences.

vise init

Create the compliance contract folder.
vise init [path] --request "your prompt"
  • Description: Bootstraps the local sp-vise/ workspace directories and generates the compliance configuration contract compliance.json.

Documentation Grounding

Ground coding agents in the correct API signatures and reactive lifecycle patterns of the social.plus SDKs.

vise search-docs

Search docs for relevant pages.
vise search-docs "<query>"
  • Description: Searches the public documentation repository and returns a list of matching pages with paths, anchors, and relevance weights.

vise get-doc-page

Retrieve details of a doc page.
vise get-doc-page <path>
  • Description: Returns the full markdown content of the requested doc page for the AI agent to read.

Compliance Verification

Verify that written code does not violate security, data lifecycle, or platform constraints.

vise check

Validate current workspace against compliance contract.
vise check [path]
  • Description: Reads sp-vise/compliance.json, runs validators, compares code modifications against recorded signatures, and outputs a diagnostic scorecard.

vise validate

Run the raw rules engine.
vise validate [path]
  • Description: Runs deterministic rule checks on the workspace without matching them against active attestations.

vise sync

Sync passing rule proofs.
vise sync [path]
  • Description: Automatically generates and saves attestation proofs to sp-vise/attestations/ for all rules that cleanly passed the deterministic engine.

vise attest

Sign an attestation for a custom layout rule.
vise attest [path] --rule <ruleId> --signer <name> --confidence <level> --evidence-file <file> --rationale "..."
  • Description: Records a signed attestation for rules that pass via architectures not visible to Vise’s static analyzer (e.g. dependency injection wrappers or dynamic environment variable resolution). Saves SHA-256 signatures of target files to detect future drift.

vise explain

Print detailed guide for a rule.
vise explain <ruleId>
  • Description: Displays the diagnostic guidance, reasoning, and remediation examples for a specific rule failure.

vise status

Summarize active project state.
vise status [path]
  • Description: Displays a brief summary of the compliance contract, number of passing rules, outstanding attestations, and blocker details.

Compile & Test Sensors

Sensors verify that code actually builds and tests pass.

vise run-sensors

Run local build, test, and typecheck sensors.
vise run-sensors [path]
  • Description: Automatically detects and executes your project’s local compilers, type checkers, linters, and unit test suites (e.g. npm run build, flutter analyze, gradle assemble). Never runs unverified shell configurations.
  • Options:
    • --dry-run: Prints a list of the sensor commands Vise would execute without running them.

Skill Management

Skills teach your AI agents how to interface with Vise.

vise install-skill

Install Vise skill configurations into an editor.
vise install-skill --target <editor> [path]
  • Description: Writes skill markdown specifications into the editor workspace instructions.
  • Supported targets: claude, claude-project, cursor, cursor-rules, vscode, copilot, agents.

vise print-skill

Print skill markdown to stdout.
vise print-skill
  • Description: Prints the raw markdown skill file for manual copy-pasting into generic AI agent environments.

MCP Adapter

Expose Vise capabilities as tool calls to AI clients.

vise mcp

Start the stdio Model Context Protocol (MCP) server.
vise mcp
  • Description: Launches a stdio MCP adapter that exposes Vise inspection, planning, checking, and documentation lookup as tools to compatible editor clients.