zcode-keysmith is a tool that installs a managed system-role.md entry point for the ZCode desktop app, allowing users to inject custom system prompts into the ZCode agent-server runtime without modifying the original application.

Stars

54

7-day growth

No data

Forks

13

Open issues

0

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a non-invasive, version-managed way to customize the system prompt for ZCode's AI agent, using a wrapper that modifies only the runtime environment and preserves the original app integrity, with built-in backup, dry-run, and verification commands.

Who it is for

  • ZCode desktop app users who want to customize the agent's system role
  • Developers building AI agents or workflows on top of ZCode
  • Power users on macOS seeking fine-grained control over prompt injection
  • Users who need versioned management of system instructions across updates

Use cases

  • Setting a custom system prompt for ZCode's AI agent to enforce behavior or context
  • Managing and versioning system role files for different projects or environments
  • Restoring or rolling back system prompt configurations using automatic backups
  • Verifying that the custom wrapper is correctly invoked after ZCode relaunches

Strengths

  • Non-invasive installation – writes only to user directory and LaunchAgent, leaving ZCode app untouched
  • Managed operations with dry-run mode, automatic backups, and verification commands
  • Persistence via LaunchAgent ensures environment variables survive login sessions
  • Automatic format normalization (cleans ChatML wrapper tags) when copying system-role.md

Considerations

  • macOS-only due to dependency on LaunchAgent and macOS-specific paths
  • Requires ZCode app to be installed and users must relaunch ZCode after installation
  • No graphical interface; all operations are command-line based

README quick start

安装

Description

ZCode App managed true system-role entrypoint

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
programmersd21
Featured
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal
277