Is improve still maintained?

Yes, active. Last change 2 months ago.

Some track record. 11k stars, 5 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to set up improve (shadcn/improve) · gitmanual

Assembly instructions

shadcn/improve

Use your most capable model to audit your codebase and write plans for cheaper models to execute.

Unknown stack

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 2 months ago.
Can I trust it?: Some track record11k stars, 5 months old. Get it from the official repo and read what it installs.

Difficulty: Easy
Time: about 5 min
Stars: ★ 11,482
Activity: Updated 2 months ago

Fresh setup, read just now

Will it work on macOS?

Not sure yet

We couldn't spot a known setup. The README below is your best guide.

Your system

macOS Windows Linux

Before you start: Usage

/improve                        full audit → prioritized findings → plans
/improve quick                  cheap pass: hotspots, top findings only
/improve deep                   exhaustive: every package, every category
/improve security               focused audit (also: perf, tests, bugs, ...)
/improve branch                 audit only what the current branch changes
/improve next                   feature suggestions — where to take the project
/improve plan <description>     skip the audit, spec one thing
/improve review-plan <file>     critique and tighten an existing plan
/improve execute <plan>         dispatch a cheaper executor, review its work
/improve reconcile              refresh the backlog: verify, unblock, retire
/improve ... --issues           also publish plans as GitHub issues

2 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/shadcn/improve.git
cd improve

Follow the README: Usage

In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.

/improve                        full audit → prioritized findings → plans
/improve quick                  cheap pass: hotspots, top findings only
/improve deep                   exhaustive: every package, every category
/improve security               focused audit (also: perf, tests, bugs, ...)
/improve branch                 audit only what the current branch changes
/improve next                   feature suggestions — where to take the project
/improve plan <description>     skip the audit, spec one thing
/improve review-plan <file>     critique and tighten an existing plan
/improve execute <plan>         dispatch a cheaper executor, review its work
/improve reconcile              refresh the backlog: verify, unblock, retire
/improve ... --issues           also publish plans as GitHub issues

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 1 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.