v0.2.0-alpha.1: Native subscriptions

Native subscriptions, no API-key setup

This alpha replaces ungrok's previous inference path with official Claude Code and Codex clients. Sign in with your own subscription on Grok Bot's computer. ungrok does not extract native login tokens or fall back to API billing.

• Claude Code 2.1.263 and Codex 0.153.4 are the supported client versions.
• Grok remains the tool executor. Native tools, MCP, and hooks are restricted by runtime controls.
• Setup, login, probe, update recovery, and the copy-paste assistant guide now use subscriptions only.
• OpenClaw's native-client and restricted-runtime implementation informed the design. Applicable MIT attribution is preserved.
• The OpenManus comparison now uses verified Yes/No entries for built-in capabilities.

Verification

106 automated tests pass: 50 Python and 56 Node tests. The source archive is reproducible and includes an opt-in synthetic native verification script.

Real local ChatGPT subscription checks passed for text, a host-tool proposal, a supplied tool result and follow-up, two binary images, and image follow-up. Claude passed text, a host-tool proposal, two binary images, and image follow-up. Claude's tool-result follow-up was refused by provider safeguards. The refusal is surfaced without retrying or changing billing routes.

This is an alpha, not verified live Grok host support. Clean Linux Grok host setup/restart/repair/rollback and actual in-app tool execution remain unverified. Native responses are buffered and each host step starts a fresh invocation. Subscription limits and Grok charges still apply. Publishing this release does not change existing bots.

Migrating from 0.1

Do not stack the new adapter over an old hook. Follow the migration guide and use the old checkout for its verified same-version rollback. Legacy API configuration is rejected without being overwritten or deleted. The obsolete compatibility patch is no longer shipped; prior tagged releases remain available for recovery.

Start with the README and docs/getting-started.md. Check the archive against SHA256SUMS before use.

ungrok v0.1.0-rc.2 — easier setup

Easier setup, starting from the Grok Bot app

This candidate replaces the technical prerequisites-first quick start with two paths:

• Let your AI assistant help: copy-paste prompt, provider choices, private keys, approvals, and real verification.
• Follow the walkthrough: open the app, find its remote computer, choose a model service, install, and test.

The new provider guide covers OpenRouter without a proxy and optional LiteLLM installation for direct Anthropic API access. It explains the three setup values, separate API billing, and streaming/tools in plain language. The optional proxy is a supervised foreground recipe, not an unattended service, and has not been live end-to-end tested by ungrok.

Installer/adapter behavior is unchanged from rc.1 apart from clearer setup prompts and the version string. This remains a prerelease with the same clean-host live-verification gaps. No existing Grok computer or Mac app is updated automatically.

Verification and download

Commit: b27cba69111acaa094b062ff2f6e408348b2af1c.

45 Python and 40 Node tests pass locally and from the extracted archive. Two source builds are byte-identical. CI covers Python 3.10/Node 20 and Python 3.12/Node 22.

Download both assets, then run sha256sum -c SHA256SUMS on Linux or shasum -a 256 -c SHA256SUMS on macOS before extracting.

Archive SHA-256: 72d2e6bff0b36c3e1cb114a5f2e30868cdbbffb5e78a9b5a3cb002ddd8afa068.

Checksums detect changed downloads; they are not signed attestations. Use the tagged guides and retain the exact checkout and backups for recovery.

ungrok v0.1.0-rc.1

Bring your own model to Grok Bot. This is the first release candidate, not a stable-support claim.

Included

• A reversible host installer with doctor, setup, probe, repair, supervised restart, and hash-checked rollback.
• Private per-session provider configuration with no implicit Grok login fallback.
• Image handling that preserves user requests through follow-ups, bounded request-copy resizing, streamed output, and cancellation.
• Safe failures for invalid images, incomplete streams, malformed tool arguments, and changed installation files.
• Version-pinned onboarding, recovery instructions, upstream MIT attribution, and a corrected banner mark.

Verification

Release commit: f081a59b8f55637798552e59e5b1bedc837bbfd8.

45 Python tests and 40 Node tests pass locally and from the extracted source archive. Two independent builds produced identical archive bytes. CI for this exact commit passed on Python 3.10/Node 20 and Python 3.12/Node 22.

Download ungrok-0.1.0-rc.1.tar.gz and SHA256SUMS, then run sha256sum -c SHA256SUMS on Linux or shasum -a 256 -c SHA256SUMS on macOS. These checksums detect changed downloads; they are not signed attestations.

Expected archive SHA-256: 026f6af6643a88bd888fe52bdec3969eb0103ea696ce6307aa8563ff23aacf33.

Before installing

Start with the tagged setup guide and compatibility record. Run the installer inside the Grok computer, not on your Mac. You need authorized API or gateway access. ungrok supplies no model access or proxy.

The legacy compatibility repair has narrow live text, image, and follow-up results. The hardened new-install path still needs clean-host, end-to-end setup, restart, repair, and rollback verification. Do not use this candidate on a computer you cannot recover. Private host updates can break compatibility, and no claim is made about every tool, voice, routine, provider, or billing path.

This release does not modify the Mac app or add pre-upload resizing. It does not update an existing live installation automatically. See the stable-release gates.