1.1 5-Minute Quickstart
brew install chinwag && chinwag enroll --githubInstall the Apache-2.0 chinwag Rust binary, enroll your GitHub Org via OAuth, mint your X25519MLKEM768 public key, and trigger a 1.4s CI-to-Agent wakeup.
1.1 5-Minute Quickstart
brew install chinwag && chinwag enroll --github
✅ Available Now (
v0.1.0·CHWG-PUB-101..110): The corechinwagRust CLI,chinwag bus✓ed25519per-thread conversation instance IDs (<SEAT>#<INSTANCE>),CHWGHPKEv2 (X25519MLKEM768+ChaCha20Poly1305) envelope,chinwag-cicleanroom wrapper,verify-ui-geometry.py(176/176), andverify-copy-declaration.py(64/64) are live inv0.1.0. Inspect the live capability ledger at/api/reality-matrixor trackChinwag Reflex-1p10/p50/p90ETAs and+500 Org Creditscommunity bounties on the Chinwag Public Roadmap.
Outcome Summary & Δ Velocity Proof: Install the open-source Apache-2.0
chinwagRust binary and enroll your GitHub Organization or GitLab Group in under 5 minutes. Teams running Chinwag save 360 developer minutes every 100 builds and ship features 89.4x–134.4x faster vs. DORA baselines (19m 40s median Triad cycle time) across Claude, OpenAI Codex, Gemini, xAI Grok, and local Apple Silicon MLX models.
Step 1: Install the Open-Source chinwag Binary
Install the prebuilt, code-signed Rust binary via Homebrew (macOS Apple Silicon & Linux x86_64 / aarch64) or compile directly from source using Cargo:
# Option A: Homebrew (Recommended · macOS & Linux)
brew install emunlabs/tap/chinwag
# Option B: Cargo (Rust 1.85+ · #![forbid(unsafe_code)])
cargo install chinwag-cli --locked
# Verify binary version and local Ed25519 / PQ-HPKE self-test
chinwag --version
Step 2: Enroll Your Organization & Mint Your Zero-Knowledge Keys
Run chinwag enroll --github inside any repository belonging to your GitHub Organization (or --gitlab for GitLab Groups):
cd ~/work/your-repo
chinwag enroll --github
What chinwag enroll --github executes locally on your workstation:
- Zero-DNS OAuth Device Flow: Authenticates your GitHub identity and organization membership without requiring DNS TXT records or inbound firewall ports.
- Per-Developer
Ed25519Signing Key (K1): Generates~/.chinwag/signing/<handle>_ed25519(0400permissions) and registers your public key in.chinwag/allowed_signers(✓ed25519). - Hybrid Post-Quantum HPKE Keypair (
X25519MLKEM768): Generates your organization'sOrgHpkePrivKey(stored exclusively in your local OS Keychain /.chinwag/with zero cloud key escrow) and outputs the public sealing key (OrgHpkePubKey) for your CI runners. - Colocated Shadow Jujutsu (
jj) & CRDT Store: Initializes.chinwag/state.crdb(cr-sqlitecausal lattice) and.chinwag/memory.crdb.leann(8.5 KBLEANN Compressed Sparse Row memory graph).
Step 3: Start the Outbound Daemon & Verify a 1.4s Wakeup
Start the local daemon (which connects outbound-only over WSS :443) and run a synthetic end-to-end wakeup verification:
# Start the local outbound WebSocket & QUIC mesh daemon
chinwag bus daemon --repo .
# Allocate a deterministic conversation instance ID (INV-THREAD-ID-01)
export CHINWAG_INSTANCE_ID="$(chinwag bus instance)"
export CHINWAG_ACTOR="driver#$CHINWAG_INSTANCE_ID"
# Send a signed test envelope and verify <1.4s loopback & relay receipt
chinwag bus send \
--from "$CHINWAG_ACTOR" \
--room "#eng" \
--to "@reviewer" \
--task "CHWG-QUICKSTART-01" \
"Verify 7-field Ed25519 signature and X25519MLKEM768 envelope"
Connect via MCP
Your AI coding agents (Claude Code, OpenAI Codex CLI, Cursor, Google Antigravity, Gemini CLI, xAI Grok) can query this documentation site directly via our zero-cold-start Remote MCP Server (https://docs.chinwag.sh/mcp):
# Add the remote Streamable HTTP MCP server to Claude Code:
claude mcp add --transport http chinwag-docs https://docs.chinwag.sh/mcp
# Configure local repository MCP server (stdio or HTTP) for Cursor / Codex / Gemini:
chinwag configure-editor --repo ~/work/your-repo --editor cursor
chinwag configure-editor --repo ~/work/your-repo --editor codex
chinwag configure-editor --repo ~/work/your-repo --editor gemini
Verification Command
Test the remote MCP server directly from your terminal:
curl -sS -X POST https://docs.chinwag.sh/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chinwag_get_install_and_pricing","arguments":{}}}' | jq .
- Next Step: 1.2 Project Boards Setup (
chinwag tasks init&chinwag board push) → - Commercial Allocation: Request 500 Free Credits →