Jia-Ethan/grok-keysmith

Preview-first Grok Build instruction deployment with compat and hook isolation, durable recovery, and layered uninstall.

What it solves

grok-keysmith is a deployment tool designed to safely manage custom instructions (home rules) for Grok Build. It allows users to deploy, verify, and undo changes to their global configuration without manually editing critical files like AGENTS.md.

How it works

The tool operates by managing specific files within the ~/.grok directory. It deploys a Markdown file as ~/.grok/rules/99-keysmith.md so that new Grok sessions load these rules. To ensure stability, it injects a compatibility isolation block into config.toml and disables existing hooks by renaming the ~/.grok/hooks/*.json directory to .json.disabled.

It follows a "preview-first" approach, requiring an explicit --yes flag to commit any changes to the disk. It also provides mechanisms to reconcile configuration drift, restore hooks, and perform a full uninstallation of the deployed rules.

Who it’s for

Developers and power users of Grok Build who want to customize their AI agent's global behavior through custom instructions while maintaining a backup and safe rollback mechanism.

Highlights

  • Safe Deployment: Uses a dry-run preview before writing to disk.
  • Non-Destructive: Does not modify AGENTS.md and creates backups of replaced files.
  • Configuration Management: Handles config.toml isolation and hook disabling to prevent conflicts.
  • Reversible: Provides dedicated commands to restore hooks and fully uninstall the deployment.
  • Cross-Platform: Supports macOS, Linux, and Windows (Python 3.8+).
  • Session Scripting: Includes a run --session-script feature to feed multi-turn conversations into a single Grok session.

Related

  • Project
    Jia-Ethan/codex-keysmith

    A tool for injecting custom, revocable instructions into Codex AI programming tools to customize behavior in new conversations without modifying the software.

  • Project
    Jia-Ethan/claude-keysmith

    A tool for adding revocable custom instructions to Claude Code, allowing users to preview changes before applying them to new AI conversations.

  • Dispatch
    Grok Build Workflows Release

    xAI has introduced Workflows in Grok Build, allowing users to orchestrate complex tasks by fanning them out across hundreds of parallel agents that verify results and report back in a single background run.

  • Dispatch
    Grok Build Open Source Release

    xAI has open-sourced Grok Build, a coding agent and terminal user interface (TUI) that supports local-first execution and an extensible extension system.

  • Dispatch
    xAI Grok Build Early Beta Release

    xAI has launched Grok Build, a coding agent for professional software engineering designed for complex coding tasks through a plan-review-approve workflow and parallel subagent execution.