English

Keysmith installs instructions onto local AI coding tools: preview, apply, verify, and undo.

claude-keysmith is the installer for Claude Code. After it is on, new conversations follow the instruction. The app itself is not modified, and accounts and keys are never read.

[!IMPORTANT] This changes later new conversations in Claude Code. Commands show the plan first and write only when you confirm. Open a new session after installing.

How it works

1. Preview first. Nothing is written until you confirm.
2. Apply when ready. The instruction is installed locally. The app stays official.
3. Start a new conversation. A fresh session is required.
4. Remove it whenever you want. Review the plan, then restore how it was.

Which Keysmith to use

You use	Installer	How to start
Codex	codex-keysmith	Stable package
Claude Code	claude-keysmith	Source
Grok Build	grok-keysmith	Stable package
ZCode	zcode-keysmith	Source

One installer per tool. An unsigned desktop build is also available.

Results

On the same model and the same 4 prompts, complete artifacts rose from 1 to 3.

Get started

Claude Code must already be installed. Source install is the conservative path.

git clone --branch v7.2 --depth 1 https://github.com/Jia-Ethan/claude-keysmith.git
cd claude-keysmith
python3 claude-instruct.py install --scope project --project-dir .
python3 claude-instruct.py install --scope project --project-dir . --yes

Then open a new Claude Code session. You can also hand the agent-install notes to an AI assistant. Details live in the guide.

Undo

python3 claude-instruct.py uninstall --scope project --project-dir .
python3 claude-instruct.py uninstall --scope project --project-dir . --yes

Review the plan, then confirm.

Platform

macOS, Windows, and Linux. Python 3.8+.

Docs

• Guide
• Agent install
• Privacy

Series

• codex-keysmith — for Codex
• claude-keysmith — for Claude Code
• grok-keysmith — for Grok Build
• zcode-keysmith — for ZCode

Feedback: GitHub Discussions · Community: LINUX DO

Star History