Airsc is free for everyone. If it helps you, support it with $2–$20.

Support
PluginCautionAgent workflow & memorySome setup

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.

10 stars2License: MITUpdated 27 days ago0 opens

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

Caution

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.

  1. Get the app: download it from claude.com/download, open it, and log in (Pro or Max plan).

  2. 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 sh
    

    The yes parts turn on its reminders, update notices, and safety guards.

  3. 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 (or no).
  • Check the whole factory: bun run verify --all
  • Take a product live: /go-live connects your accounts once, /security-check reviews the product, and /ship puts it on a URL you can share.
  • Just want one piece? claude plugin marketplace add hamza-ali-shahjahan/hamzaish installs web-launch or repo-scout into your own project.
  • Windows: use WSL and follow the Mac and Linux steps, or use the desktop-app guide.
  • Git-facing commands such as /pr use 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
View source on GitHub