Install once. Edit Markdown safely.

Use Incise from the command line, install the native Pi package, or connect the version-matched Hermes plugin. Pi and Hermes provide measured automatic profiles for MiniCPM, Ornith, and Gemma; unknown models keep the stable standard interface.

Command-line installation

cargo install incise-cli --locked
incise --version

Linux and macOS archives are also available from GitHub Releases.

Pi installation

pi install npm:pi-incise

The npm package includes native binaries for macOS arm64/x64 and glibc Linux arm64/x64.

INCISE_PROFILE=auto pi --thinking off

INCISE_PROFILE=auto pi

INCISE_PROFILE=auto pi --thinking off

INCISE_PROFILE=standard pi

Hermes Agent installation

Install the CLI first, then download the plugin bundle from the same release:

release="v$(incise --version | awk '{print $2}')"
mkdir -p "$HOME/.hermes/plugins"
curl --fail --location --silent --show-error \
  "https://github.com/pdalinis/incise/releases/download/$release/incise-hermes-$release.tar.gz" \
  | tar -xz -C "$HOME/.hermes/plugins"

hermes plugins enable --no-allow-tool-override incise
hermes tools enable --platform cli incise
hermes plugins doctor --ci incise

Keep the CLI and plugin on the same release. Doctor prints the exact Incise binary it validated and reports eight handlers for standard or twenty-eight for auto; request middleware narrows the latter to exactly one routed Incise tool or the standard eight before inference.

INCISE_PROFILE=auto hermes chat

INCISE_PROFILE=auto hermes chat --reasoning none

INCISE_PROFILE=auto hermes chat --reasoning none

The preregistered Hermes profiles completed 480/480 trials on MiniCPM, Ornith, and Gemma with zero harmful outcomes.

The editing loop

1. Inspect the relevant document structure.
2. Address the target by its content.
3. Preview or perform one semantic operation.
4. Verify the concise result or follow the remedy in a refusal.

incise tables vault/Projects.md
incise rows vault/Projects.md --table Projects
incise table-update-cell vault/Projects.md \
  --table Projects --where Note=Launch \
  --column Status --value done

# Whole-table deletion previews first and requires explicit confirmation.
incise table-delete vault/Projects.md --table Projects
incise table-delete vault/Projects.md --table Projects --confirm

Add --ordinal N when several tables share a heading. Whole-table deletion is CLI-only in this release; Pi and Hermes retain the measured four-action table_edit schema.

Structural checks

incise check detects structural conditions that can make Incise addressing ambiguous or prevent a byte-preserving operation. It is not a Markdown style linter, and checking never changes the file.

incise check vault/Projects.md --json

# Reserved for findings classified as automatic; HASH comes from the report.
incise check vault/Projects.md --fix-safe --if-match HASH --json

Each finding has a stable code, severity, semantic address, byte span, and repair class. automatic findings may use the hash-guarded safe-fix path; explicit findings name an existing Incise operation that still requires matching user intent; manual findings should be reported instead of patched around. Version 0.5.0 starts with an empty automatic allowlist.

Supported structures

Agent integrations

Print the standard function schemas with incise schema or inspect the experimental narrow surface with incise schema --profile safe-small. The confirmed whole-table deletion command is intentionally absent from those model schemas after its publication gate failed. See the complete guides for Hermes Agent and Pi.