This document describes how knowing is distributed, what is automated, and what is planned.
v0.1.2 is live across all channels. The release pipeline is fully automated on v* tag push.
| Channel | Status | Version |
|---|---|---|
| GitHub Release | Live | v0.1.2 (4 platform binaries) |
| Homebrew | Live | brew install blackwell-systems/tap/knowing |
| npm | Live | @blackwell-systems/knowing@0.1.2 |
| PyPI | Live | knowing==0.1.2 |
| Docker (GHCR) | Live | ghcr.io/blackwell-systems/knowing:v0.1.2 |
| Docker (Hub) | Live | blackwellsystems/knowing:v0.1.2 |
| MCP Registry | Live | io.github.blackwell-systems/knowing |
| Go install | Live | go install ...@v0.1.2 |
| OS | Architecture | Build method |
|---|---|---|
| Linux | amd64 | Native GCC on ubuntu-latest |
| Linux | arm64 | Cross-compile via aarch64-linux-gnu-gcc |
| macOS | arm64 | Native clang on macos-latest |
| macOS | amd64 | Cross-compile clang on macos-latest |
| Secret | Purpose |
|---|---|
NPM_TOKEN |
npm publish |
PYPI_TOKEN |
PyPI wheel upload |
HOMEBREW_TAP_TOKEN |
Push formula to homebrew-tap |
DOCKERHUB_USERNAME |
Docker Hub login |
DOCKERHUB_TOKEN |
Docker Hub push |
Pre-built binaries for all platforms, published automatically by GoReleaser on every v* tag.
| Platform | Architecture |
|---|---|
| macOS | arm64, amd64 |
| Linux | arm64, amd64 |
| Windows | arm64, amd64 |
brew install blackwell-systems/tap/knowing
Formula in blackwell-systems/homebrew-tap updated automatically by GoReleaser on every release.
curl -fsSL https://raw.githubusercontent.com/blackwell-systems/knowing/main/install.sh | sh
Detects OS and architecture, downloads the matching binary from GitHub Releases, installs to /usr/local/bin.
iwr -useb https://raw.githubusercontent.com/blackwell-systems/knowing/main/install.ps1 | iex
Detects amd64/arm64, downloads the matching zip from GitHub Releases, installs to %LOCALAPPDATA%\knowing, adds to user PATH. No admin required.
scoop bucket add blackwell-systems https://github.com/blackwell-systems/knowing
scoop install blackwell-systems/knowing
Manifest at bucket/knowing.json in this repo (the repo doubles as the Scoop bucket). autoupdate configured so scoop update knowing picks up new releases automatically.
winget install BlackwellSystems.knowing
Manifests at winget/manifests/b/BlackwellSystems/knowing/. Submit new versions as a PR to microsoft/winget-pkgs.
npm install -g @blackwell-systems/knowing
Uses the optionalDependencies pattern (same as esbuild): a root package with a JS shim and six platform-specific packages each containing the native binary. npm installs only the package matching the current platform.
Published automatically by the npm-publish CI job after GoReleaser completes.
Packages:
@blackwell-systems/knowing (root; install this)@blackwell-systems/knowing-darwin-arm64@blackwell-systems/knowing-darwin-x64@blackwell-systems/knowing-linux-arm64@blackwell-systems/knowing-linux-x64@blackwell-systems/knowing-win32-x64@blackwell-systems/knowing-win32-arm64# GHCR
docker pull ghcr.io/blackwell-systems/knowing:latest
# Docker Hub
docker pull blackwellsystems/knowing:latest
All images are multi-arch (linux/amd64 + linux/arm64) via Docker manifest lists. Native performance on Apple Silicon and AWS Graviton, with no Rosetta/QEMU emulation. Built and pushed to both registries automatically by GoReleaser on every v* tag. Tags: latest, semver (0.1.2, 0.1).
Published automatically via mcp-publisher in CI using GitHub OIDC (no secrets required).
Server name: io.github.blackwell-systems/knowing
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.blackwell-systems/knowing"
Listed at glama.ai/mcp/servers/blackwell-systems/knowing. Profile managed via glama.json in repo root.
pip install knowing
Platform-specific wheels containing the Go binary. Each wheel is tagged with the correct platform (e.g. macosx_11_0_arm64, manylinux2014_x86_64), so pip resolves the right one automatically. No Go toolchain required. Built and published automatically by the pypi-publish CI job on every release tag.
knowing update # Download and replace binary with latest release
knowing update --check # Compare current vs latest version without downloading
knowing update --force # Update even if already on the latest version
Fetches the latest release from the GitHub Releases API, downloads the correct binary for the current OS and architecture, and atomically replaces the running binary. Works regardless of the original install method.
knowing uninstall # Remove all configs, database, caches
knowing uninstall --dry-run # Preview what would be removed
Removes MCP server entries from .mcp.json, .cursor/mcp.json, and other config files. Removes the knowing database and cache directories. Does not remove the binary itself (prints the rm $(which knowing) command for manual removal).
go install github.com/blackwell-systems/knowing/cmd/knowing@latest
Requires a Go toolchain. Builds from source and installs to $GOPATH/bin.
smithery.yaml in the repo root enables auto-indexing on Smithery. Auto-discovered from GitHub.
Submitted. Listed under Developer Tools.
Manually submitted. Free listing.
Submitted to punkpeye/awesome-mcp-servers.
URL: knowing.dev (planned)
Built with mkdocs-material from the docs/ folder. Deployed to GitHub Pages automatically on every push to main. Custom domain via Cloudflare DNS.
Every git tag v* push triggers three sequential CI jobs:
release → GoReleaser: binaries, GitHub Release, Homebrew formula,
Docker images (GHCR + Docker Hub)
npm-publish → downloads binaries from GitHub Release, publishes 7 npm packages
mcp-registry-publish → publishes metadata to official MCP Registry (GitHub OIDC)
Docker images are built inside the release job by GoReleaser (dockers: section). Multi-arch manifest lists built for linux/amd64 + linux/arm64.
| Channel | Status | Notes |
|---|---|---|
| Not posted | Launch announcement ready. | |
| Not posted | r/mcp, r/ClaudeCode, r/golang. | |
| Hacker News | Not submitted | “Runtime traces as graph edges” angle is HN-ready. |
| Go Weekly | Not submitted | Submit blog post link. |
| Twitter/X | Not active | Thread format works for the data. |
| glama.ai | Planned | MCP server discovery. |
| Product Hunt | Not launched | Save for bigger release (runtime traces). |
| YouTube | Not started | “Watch a codebase build its own knowledge graph” demo. |
| List | Stars | Status | Section |
|---|---|---|---|
| punkpeye/awesome-mcp-servers | 86K | Planned | Developer Tools |
| ComposioHQ/awesome-claude-skills | 59K | Planned | Development & Code Tools |
| hesreallyhim/awesome-claude-code | 43K | Planned | Tooling |
| wong2/awesome-mcp-servers | 4K | Planned | Community Servers |
| ai-for-developers/awesome-ai-coding-tools | 1.7K | Planned | MCP Servers and Directories |
| rohitg00/awesome-claude-code-toolkit | 1.6K | Planned | Skills |
| avelino/awesome-go | 172K | Blocked (5-month history req) | Go Tools |
| Channel | Notes |
|---|---|
| Nix flake | nix run github:blackwell-systems/knowing |
| mcp.so | Top Google result for “MCP servers”; direct submission |
| VS Code extension | Zero-setup path for Copilot/Continue/Cline users |
| OTel Collector contrib | knowing as an OTel exporter plugin for direct trace ingestion |
| GitHub Marketplace | GitHub Action for CI-integrated indexing and semantic PR diffs |