Skip to content

rigswig 0.1.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 16:54
· 79 commits to main since this release

The first release of rigswig: see everything your coding agent loads before you type, and where each piece came from.

A coding agent's harness is everything around the model: instruction files, agents, skills, commands, hooks, MCP
servers, plugins, permissions and the model setting, spread across user, project, local and managed scopes. rigswig
reads it for a repo, shows what a session there actually gets, which scope decided each setting, what is overridden,
and roughly how much context it costs before the first message, then tells you what to trim.

What's in 0.1.0

  • rigswig status: the harness of a repo, by kind and by layer, with the context estimate and its largest items.
    Claude Code, OpenAI Codex CLI, Hermes Agent and Ollama, each modelled from its own documentation
    (docs/adapters).
  • rigswig audit: ranked findings, each with its evidence, the tokens it would save and a proposed fix:
    user-scope agents and skills nothing in the repo references, plugins the repo has no files for, instruction files
    over budget, text repeated across layers, dead references, a CLAUDE.md that never imports its AGENTS.md, and
    permission rules that are risky, one-off or already covered. Fleet mode (--repos '~/code/*') says which repos
    need each user-scope item, and what to archive or move to project scope.
  • rigswig ui: the same as a local page on 127.0.0.1, behind a random token: the budget on your model's context
    window, every item, settings with the layers that set them, a compare view, and the audit with a progress bar,
    filters and links to the items each finding names. Read-only unless started with --allow-writes (plugins and
    project MCP servers on and off, each with a preview, a backup and undo).
  • rigswig compare: two repos, or two harnesses on one repo.
  • rigswig check: limits for CI (--max-tokens 40k, --max-item-tokens, --no-warnings), and --without
    what-ifs on status and check.
  • --github owner/repo and --archive repo.tar.gz: audit a repo without cloning it. The archive is unpacked
    into memory, never onto disk, and read with an empty home folder, so your own setup is not part of the result
    (docs/GITHUB.md).

Guarantees

No model calls. No telemetry. No network request unless you ask for one with --github (one public archive from
codeload.github.com); build with --no-default-features for a rigswig with no network code at all. Nothing written
unless the page is started with --allow-writes. No secrets printed or served. No transcripts read. A folder listed in
~/.rigswig/private.json is refused as a repo and skipped by fleet mode.

Install

Download the archive for your platform below, check it against SHA256SUMS, and put rigswig on your PATH:

Platform Asset
macOS, Apple Silicon rigswig-v0.1.0-aarch64-apple-darwin.tar.gz
macOS, Intel rigswig-v0.1.0-x86_64-apple-darwin.tar.gz
Linux x86_64 (static) rigswig-v0.1.0-x86_64-unknown-linux-musl.tar.gz
Linux arm64 (static) rigswig-v0.1.0-aarch64-unknown-linux-musl.tar.gz
Windows x86_64 rigswig-v0.1.0-x86_64-pc-windows-msvc.zip

The binaries are not signed or notarized yet. On macOS, one downloaded through a browser may need
xattr -d com.apple.quarantine ./rigswig before it runs. Or build from source: cargo install --git https://github.com/overfocus/rigswig rigswig. Added after this release was drafted: 0.1.0 is also on crates.io (cargo install rigswig) and npm
(npx rigswig). Homebrew is not set up yet.

Before 1.0

The JSON (status --json, schema version 0.1.0) may change in a minor release until 1.0. Every adapter lists what it
does not model in coverage.notModelled; see the roadmap
for what comes next.