Skip to content

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
Assets 5
Loading