Skip to content

v0.1.1

Choose a tag to compare

@github-actions github-actions released this 21 Jul 14:01

Changes since v0.1.0.

Highlights

Single-binary CLI (server control)

The supragnosis binary is now driven by subcommands (clap). Running it with no
arguments
still starts the stdio MCP server, so MCP clients that launch it as a child
process keep working unchanged.

  • serve [--http --viz --store --data-dir --host --workspace --embed --session] - foreground
    run (stdio by default; --http starts the streamable-http daemon, --viz the live viewer).
    Flags take precedence over the SUPRAGNOSIS_* environment variables.
  • start / stop / restart / status - a self-managed background daemon (pidfile
    ~/.supragnosis/supragnosis.pid + logs ~/.supragnosis/log), so it runs without launchd.
    status also detects an externally-managed daemon (e.g. launchd) via a port health check
    even when there is no pidfile.

English codebase and docs

The entire repository is now English: all source comments and user-facing strings (error
messages, logs, MCP tool/resource descriptions, the live viewer UI, CLI help/output), every
Cargo.toml, the install scripts, and all design docs (architecture, principles,
proposal-workflow, README, deploy). Behavior is unchanged - only prose was translated, and
test-asserted strings were updated in lockstep.

Viewer

Node size and inter-node spacing now scale with neighbor count (degree): hubs are larger and
get more surrounding room, while sparsely-connected nodes stay small and tight.

install.sh

Added --help (usage, options, environment variables) and clearer post-install onboarding
(stdio registration, optional daemon + viewer, docs links).

Install

curl -fsSL https://raw.githubusercontent.com/Ashon/supragnosis/main/scripts/install.sh | sh

Or download the platform tar.gz from the assets below, extract it, and put supragnosis
on your PATH. Supported: macOS (arm64 / x86_64), Linux (x86_64); each asset ships a .sha256.

  • CLI: supragnosis --help. Register with an MCP client: claude mcp add supragnosis -- ~/.local/bin/supragnosis.

Notes / limitations

  • The prebuilt binary is keyword + hashing search. For local ONNX semantic search, build
    from source with cargo build --release --features fastembed.
  • HTTP daemon / viewer are loopback-only (no auth) - a local trust surface. Remote exposure,
    auth, and TLS are future work.
  • 0.x early release - the storage format and surfaces may still change.