nklisch

nklisch / claude-code-modes

Public

CLI wrapper that launches Claude Code with behaviorally-tuned system prompts — control agency, quality, and scope instead of fighting the defaults

24
1
100% credibility
Found Apr 07, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A tool that customizes Claude Code's behavior by assembling and applying task-specific system prompts through presets like 'create', 'safe', or 'explore'.

How It Works

1
🔍 Discover flexible AI coding help

You hear about a simple tool that lets your AI coding assistant switch personalities to match different tasks, like building new projects or safely tweaking code.

2
📥 Get the tool ready

Download and prepare the modes tool on your computer so it's easy to use alongside your AI helper.

3
Pick a mode for your task
🚀
Build new

For starting fresh projects with smart structure.

🔧
Tweak safely

For small, precise changes without risks.

🔍
Explore code

For reading and understanding without changes.

♻️
Refactor freely

For reorganizing and improving the whole codebase.

4
✨ Launch in your project

Run the chosen mode right in your coding folder, and your AI instantly adapts its style.

5
💬 Chat and create

Talk to your AI as it builds, explains, or refines code exactly how you asked, feeling confident and in control.

🎉 Perfect results

Your code project turns out just right, faster and better tailored to your needs.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 24 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-code-modes?

This TypeScript CLI wrapper launches Claude Code with behaviorally-tuned system prompts, letting you control its agency, code quality, and task scope via simple presets like `create`, `extend`, `safe`, `refactor`, `explore`, or `none`. Claude Code's defaults make it overly cautious and terse—great for tweaks, bad for building or refactoring—while this claude cli wrapper swaps them out, preserving tools and security. Install via git clone and Bun, then run `claude-mode create` to get autonomous architect-level output.

Why is it gaining traction?

Developers ditch fighting Claude Code defaults by switching claude code modes on the fly: autonomous for greenfield builds, collaborative for safe edits, or read-only explore. Axis overrides like `--agency surgical --scope narrow` and team configs via `.claude-mode.json` enable claude code modes explained in presets, plus `--inspect` previews prompts before launch. Works on Linux, Ubuntu, Windows; integrates with gh CLI github actions or copilot workflows.

Who should use this?

Backend devs bootstrapping APIs from scratch, fullstack teams refactoring monoliths without breakage, or solo hackers exploring unfamiliar repos via read-only claude code chat modes. Ideal for anyone using Claude Code daily but frustrated by its minimalism on big tasks, especially in git repos where env-aware prompts shine.

Verdict

Grab it if Claude Code is your workflow—early at 18 stars and 1.0% credibility score, but solid docs, full test coverage, and MIT license make it low-risk to try via cli github clone. Pairs well with Bun for fast iteration; watch for upstream Claude updates.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.