hamzaish
hamza-ali-shahjahan · hamza-ali-shahjahan/hamzaish
Hamzaish is an open-source agent operating system for Claude Code that enables an AI to build, launch, and learn products across their entire lifecycle.
Open-source agent OS for Claude Code that puts you in Builder Mode — and keeps you there for the whole life of a product. Claude Code setup that builds, launches, and learns. Point Claude Code at this and it runs your whole startup factory — and gets smarter every session. Works with Cursor, Codex & Windsurf too.
Preview
What you can do with it
- Guide an AI agent from a product idea to a minimum viable product (MVP) launch.
- Implement continuous learning and improvement for AI-generated code and business processes.
- Ensure AI-developed products adhere to quality standards and guardrails throughout development.
Safety check
Usable, but read the notes first.
- ●Installer downloads a remote script and pipes it to the shell.
install.sh
Automated scan of the repo files. Always review code you run.
From the README
🏭 Hamzaish
Claude Code setup that builds, launches, and learns. Your AI writes the code. Hamzaish runs the company.
Install · What it is · What's inside · Philosophy · Docs
See it work
Unlock your Builder Mode.
Point Hamzaish at an idea — and run the whole company around the code your agent writes: idea → MVP → launch → sell → scale, with a brain that remembers every lesson and a judge that refuses to let "looks done" pass for "done."
The honesty is enforced, not promised → watch the guards run on every commit.
Quick start
Pick your path: 🌱 First time? Use the desktop app · 💻 Prefer Terminal? · ⚡ Already use Claude Code? · 🔧 Advanced
Install once, and Hamzaish works in every new chat, in any folder.
🌱 Using the Claude desktop app (easiest, no Terminal)
On Windows? Follow the Windows guide for now.
-
Get the app: download it from claude.com/download, open it, and log in (Pro or Max plan).
-
Install Hamzaish: open the Code tab, pick any folder (Documents is fine), paste this message, and press Enter. Click Allow when Claude asks to run it.
Install Hamzaish for me by running this, then tell me in plain words what happened: curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | HAMZAISH_REGISTER_HOOK=yes HAMZAISH_REGISTER_GUARDS=yes shThe
yesparts turn on its reminders, update notices, and safety guards. -
Start building: open a new chat in the Code tab so Claude picks up Hamzaish, type
/builder-mode, and describe what you want to build.
Stuck? Ask Claude: run bun run doctor in my hamzaish folder and fix what it finds.
💻 Using Terminal
No coding and no GitHub account needed. You'll paste three lines into a window called Terminal. On Windows? Follow the Windows guide instead.
Step 1 — Open Terminal
- Mac: press
⌘ Command+Space, type Terminal, and press Enter. - Linux: press
Ctrl+Alt+T.
A window opens with a blinking cursor. For each step below, paste the line into that window and press Enter. Never used Terminal before? Here's a short guide.
Step 2 — Install Claude Code (the AI that does the building)
curl -fsSL https://claude.ai/install.sh | bash
✅ When it finishes, you'll see a success message.
Step 3 — Install Hamzaish
curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | sh
It asks three yes/no questions. Type y and press Enter each time. They turn on Hamzaish's plans and receipts, update notices, and safety guards.
✅ You'll see: Ready. Your factory is at ./hamzaish
Step 4 — Start Claude Code
claude
Any folder works: Hamzaish is now in every Claude Code chat. The first time, your browser opens so you can log in with your Claude account (Pro or Max plan). If Claude Code asks whether you trust this folder, choose Yes.
Step 5 — Build your idea
Type /builder-mode followed by what you want to build, and press Enter. Hamzaish shows you a plan first, then builds it step by step. You approve each step.
If something goes wrong
command not found? Close Terminal, open a new window, and repeat that step.- Your Mac asks to install "command line developer tools"? Click Install, wait until it's done, then repeat Step 3.
- Anything else: in a new Terminal window, run
cd hamzaish && bun run doctor. It tells you what's wrong and how to fix it.
⚡ Already use Claude Code?
curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | sh
Then open Claude Code in any folder and type /builder-mode <your idea>. Update any time with bun run update, and check your setup with bun run doctor.
🔧 Advanced
Install by hand, choose the folder, check everything, go live, or install single pieces
- Install by hand (needs git and Bun):
git clone https://github.com/hamza-ali-shahjahan/hamzaish.git cd hamzaish bun run setup - Choose the folder:
curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | HAMZAISH_DIR=~/code/hamzaish sh - Answer setup's questions up front:
HAMZAISH_REGISTER_HOOK=yes HAMZAISH_REGISTER_GUARDS=yes bun run setup(orno). - Check the whole factory:
bun run verify --all - Take a product live:
/go-liveconnects your accounts once,/security-checkreviews the product, and/shipputs it on a URL you can share. - Just want one piece?
claude plugin marketplace add hamza-ali-shahjahan/hamzaishinstallsweb-launchorrepo-scoutinto your own project. - Windows: use WSL and follow the Mac and Linux steps, or use the desktop-app guide.
- Git-facing commands such as
/pruse the GitHub CLI.
What it is
An open-source agent OS that puts you in Builder Mode and keeps you there for the whole life of a product. Your agent supplies the hands. Hamzaish supplies what makes those hands a company:
- A brain — learnings, decisions, and anti-patterns in markdown, SQLite-indexed, searchable from any session. When a mistake generalizes it becomes a guardrail the next build inherits, so your second product starts smarter than your first.
- A factory — 35 agents and 45 skills + 24 commands across Ideate → MVP → Launch → Sell → Scale → Kill-or-double-down. Most AI tools stop