Skip to content

Releases: sudoHG/codex-grok-search

Release list

codex-grok-search v0.1.4

codex-grok-search v0.1.4 Latest
Latest

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 23 Jul 08:00
v0.1.4
d3bf1e2

v0.1.4 rebuilds codex-grok-search around one first principle: deliver Grok results reliably.

Highlights:

  • Reduces the wrapper to a thin Codex-to-Grok bridge running outside the current repository with a temporary isolated home.
  • Removes platform, URL, date, field, Markdown, version, login, model-catalog, and inspect preflight gates that could discard successful searches.
  • Removes local Reddit refetching and treats platform selection as a search hint instead of an exclusion rule.
  • Saves Grok’s free-form answer verbatim and returns usable output as partial even if the process later exits non-zero.
  • Keeps seven-day result retention and --keep-run, while removing the maximum-run capacity blocker.
  • Keeps quick mode free of automatic Codex browser verification unless the user explicitly requests it.

Validation:

  • 28 unit tests passed locally on Python 3.9.6.
  • GitHub Actions passed on Python 3.9 and 3.12: https://github.com/sudoHG/codex-grok-search/actions/runs/29989752441
  • A real Grok 4.5 X-search canary completed from the isolated run directory without browser verification.
  • Release assets were rebuilt twice from commit d3bf1e2c30495658c6cc08f8ce440b9fa1e62ad7 with Python 3.9.6 and matched byte for byte.
  • ZIP SHA-256: b7aca555bf1e8ce142ad2053f32c5299e04eff2b9103010efd1ea8f8d672aa6b
  • tar.gz SHA-256: da6e7926b276f82e3cc9b858754e475a3e11210dc9603de6996405663f8d87c1
Assets 5
Loading

codex-grok-search v0.1.3

codex-grok-search v0.1.3

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 23 Jul 01:19
v0.1.3
64a48a9

v0.1.3 repairs strict time-window handling without weakening result validation.

Highlights:

  • Instructs Grok to omit known out-of-window sources instead of relabeling their dates as unverified.
  • Conservatively recovers an otherwise valid payload by omitting out-of-window findings, dropping every cross-check that references them, replacing the model summary with a neutral local summary, and revalidating the full payload.
  • Records successful local repair details in result_repair and returns the exact validation_error for failures.
  • Adds regression coverage for repair safety, full-run integration, and precise diagnostics; also makes the cache-capacity test independent of wall-clock date.

Validation:

  • 96 unit tests passed locally on Python 3.9.6.
  • GitHub Actions passed on Python 3.9 and 3.12: https://github.com/sudoHG/codex-grok-search/actions/runs/29971400286
  • Release assets were rebuilt twice from commit 64a48a9dcbeb449be9ae945f1fedb4d05d450c87 with Python 3.9.6 and matched byte for byte.
  • ZIP SHA-256: d0daa5f430c7ae04f2af5df443d8e2867f54cbf07ae1da846086b923fcf2cf66
  • tar.gz SHA-256: 2b681fb579367e5b91428ac99e9fdacba311418c0e71142c43e2c4cb73ad5612
Loading

codex-grok-search v0.1.2

codex-grok-search v0.1.2

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 17 Jul 07:26
v0.1.2
0569d76

v0.1.2 removes the Grok Build CLI version gate.

Highlights:

  • No longer runs grok --version or accepts/rejects Grok based on a version string.
  • Removes fixed version ranges, version-specific errors, and exact version matching from isolation inspection.
  • Keeps the real security boundaries: trusted official installation, private binary snapshot, closed isolation inspection, disabled external integrations, sandboxing, tool allowlists, process containment, and strict result validation.
  • Adds a regression test that prevents CLI version checks from returning.
  • Updates English and Chinese documentation plus the security policy to describe the actual runtime-based compatibility boundary.

Validated with 93 unit tests on Python 3.9 and 3.12, deterministic asset rebuilds, Skill structure validation, and a real quick X-search canary using Grok Build 0.2.102.

Loading

codex-grok-search v0.1.1

codex-grok-search v0.1.1

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 16 Jul 02:47
v0.1.1
cfa94fd

v0.1.1 is a usability and reliability update.

Highlights:

  • Routes current X/Twitter and Reddit searches to codex-grok-search first.
  • Defaults to quick Grok-only research without Codex web search, link-by-link verification, or personal browser control.
  • Adds explicit quick and deep research modes; deep verification runs only when requested or required for a consequential high-risk claim.
  • Makes quick X searches use only x_search, with bounded result and search-call targets.
  • Preserves refreshed Grok authentication before starting the isolated research run, reducing false login-expired errors.
  • Keeps tests independent of the developer machine Grok login.

Validated with 93 unit tests on Python 3.9 and 3.12, deterministic asset rebuilds, Skill structure validation, and a real quick X-search canary.

Loading

codex-grok-search v0.1.0

codex-grok-search v0.1.0

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 15 Jul 17:28
v0.1.0
5478e38

codex-grok-search v0.1.0

The first stable release of codex-grok-search extends Codex research with a locally authenticated Grok Build CLI for X, Reddit, and public-web search. Codex owns task framing, validation, cross-checking, and the final answer; Grok supplies an additional real-time search layer.

This is an unofficial project and is not affiliated with xAI, X, Reddit, or OpenAI.

Highlights

  • Native Grok X Search plus web search and fetch, pinned to grok-4.5.
  • Automatic triggering for current X/Reddit posts, community evidence, platform data collection, and cross-platform research.
  • Local Reddit date verification with explicit date unverified handling when an absolute date cannot be confirmed.
  • Strict source-kind, URL, requested-window, result-schema, and session validation.
  • Private retained runs for follow-up questions, with bounded seven-day/20-run cleanup.
  • Transactional install, upgrade, and uninstall flows with locking, rollback, checksum verification, and stale-file removal.

Privacy and security

  • Grok runs from a private non-Git research directory outside the user's current repository.
  • Each run uses isolated HOME, GROK_HOME, and TMPDIR directories and copies only the local Grok authentication file needed for that session.
  • grok inspect --json must match the audited isolation schema before a search can begin.
  • Research exposes only the required X/web tools. It does not expose MCP, shell access, local-file tools, file editing, memory, or subagents.
  • Search queries, search results, and public pages still pass through xAI services; this is repository isolation, not a claim of zero data transmission.

Requirements

  • macOS or Linux under a non-root user.
  • Python 3.9 or newer.
  • Grok Build CLI 0.2.101, installed from https://x.ai/cli. Other versions fail closed pending review.
  • An active local Grok login created with grok login, with access to grok-4.5.
  • A Codex environment that supports Skills.

Install

Start a new Codex task and send:

Please install this Skill: https://github.com/sudoHG/codex-grok-search/tree/main/codex-grok-search

See the README for manual source and Release installation, checksum verification, upgrade, and uninstall commands.

Build and validation

  • Tagged repository commit: 5478e38930ffd86f06162a2f5e075717ae3dcecd.
  • Release builder: Python 3.9.6.
  • Rebuild command: python3 scripts/build_release.py --commit 5478e38930ffd86f06162a2f5e075717ae3dcecd --version v0.1.0 --output-dir OUTPUT_DIR.
  • 88 unit tests pass locally.
  • GitHub Actions passes on Python 3.9 and 3.12: https://github.com/sudoHG/codex-grok-search/actions/runs/29436463330
  • Skill structure validation, Python compilation, Git whitespace validation, privacy scanning, and reproducible-asset comparison pass.
  • ZIP and tar.gz were independently rebuilt twice and match byte for byte.
  • Both archives unpack to the exact codex-grok-search/ tree from the tagged commit.
  • Real X and Reddit canaries passed during release hardening.

Assets

  • codex-grok-search-v0.1.0.zip
    • SHA-256: af2fa80344c2bd6c2e526a346dc035f1888ead1b7aa24c34adf28240e6381b50
  • codex-grok-search-v0.1.0.tar.gz
    • SHA-256: 28c62a329acf48db68829c3df9121653c022d0cf19151ce01f3baa7a68f89729
  • SHA256SUMS
    • SHA-256: 30d84da8a0129cd3e96b136fcb5f2a1782bb498a8f676b673ceea14fc3173eec

Verify both archives after downloading all three assets:

shasum -a 256 -c SHA256SUMS
Loading

codex-grok-search v0.1.0-rc.2

codex-grok-search v0.1.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

View all tags
@sudoHG sudoHG released this 15 Jul 17:20
v0.1.0-rc.2
419b758

codex-grok-search v0.1.0-rc.2

This release candidate extends Codex research with a locally authenticated Grok Build CLI for X, Reddit, and public-web search. Codex owns task framing, validation, cross-checking, and the final answer; Grok supplies an additional real-time search layer.

This is a prerelease. It is an unofficial project and is not affiliated with xAI, X, Reddit, or OpenAI.

Highlights

  • Native Grok X Search plus web search and fetch, pinned to grok-4.5.
  • Automatic triggering for current X/Reddit posts, community evidence, platform data collection, and cross-platform research.
  • Local Reddit date verification with explicit date unverified handling when an absolute date cannot be confirmed.
  • Strict source-kind, URL, requested-window, result-schema, and session validation.
  • Private retained runs for follow-up questions, with bounded seven-day/20-run cleanup.
  • Transactional install, upgrade, and uninstall flows with locking, rollback, checksum verification, and stale-file removal.

Privacy and security

  • Grok runs from a private non-Git research directory outside the user's current repository.
  • Each run uses isolated HOME, GROK_HOME, and TMPDIR directories and copies only the local Grok authentication file needed for that session.
  • grok inspect --json must match the audited isolation schema before a search can begin.
  • Research exposes only the required X/web tools. It does not expose MCP, shell access, local-file tools, file editing, memory, or subagents.
  • Search queries, search results, and public pages still pass through xAI services; this is repository isolation, not a claim of zero data transmission.

Requirements

  • macOS or Linux under a non-root user.
  • Python 3.9 or newer.
  • Grok Build CLI 0.2.101, installed from https://x.ai/cli. Other versions fail closed pending review.
  • An active local Grok login created with grok login, with access to grok-4.5.
  • A Codex environment that supports Skills.

Install

Start a new Codex task and send:

Please install this Skill: https://github.com/sudoHG/codex-grok-search/tree/main/codex-grok-search

See the README for manual source and Release installation, checksum verification, upgrade, and uninstall commands.

Build and validation

  • Tagged repository commit: 419b758aadc96c4a42d0165ee2a8cac3a1f5c0a4.
  • Release builder: Python 3.9.6.
  • Rebuild command: python3 scripts/build_release.py --commit 419b758aadc96c4a42d0165ee2a8cac3a1f5c0a4 --version v0.1.0-rc.2 --output-dir OUTPUT_DIR.
  • 88 unit tests pass locally.
  • GitHub Actions passes on Python 3.9 and 3.12: https://github.com/sudoHG/codex-grok-search/actions/runs/29435036434
  • Skill structure validation, Python compilation, Git whitespace validation, privacy scanning, and reproducible-asset comparison pass.
  • ZIP and tar.gz were independently rebuilt twice and match byte for byte.
  • Both archives unpack to the exact codex-grok-search/ tree from the tagged commit.
  • Real X and Reddit canaries passed during release-candidate hardening.

Assets

  • codex-grok-search-v0.1.0-rc.2.zip
    • SHA-256: af2fa80344c2bd6c2e526a346dc035f1888ead1b7aa24c34adf28240e6381b50
  • codex-grok-search-v0.1.0-rc.2.tar.gz
    • SHA-256: 28c62a329acf48db68829c3df9121653c022d0cf19151ce01f3baa7a68f89729
  • SHA256SUMS

Verify both archives after downloading all three assets:

shasum -a 256 -c SHA256SUMS
Loading