{"id":48832666,"url":"https://github.com/wynelson94/shipwright","last_synced_at":"2026-04-14T21:03:31.081Z","repository":{"id":349478182,"uuid":"1191225187","full_name":"Wynelson94/shipwright","owner":"Wynelson94","description":"Describe your app in plain English. Shipwright builds, tests, and deploys it. Claude Code plugin for autonomous app building.","archived":false,"fork":false,"pushed_at":"2026-04-06T04:23:36.000Z","size":48,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T06:34:24.008Z","etag":null,"topics":["ai","ai-agent","app-builder","autonomous","claude-code","claude-code-plugin","no-code","vercel"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wynelson94.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T03:14:50.000Z","updated_at":"2026-04-06T04:26:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Wynelson94/shipwright","commit_stats":null,"previous_names":["wynelson94/shipwright"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Wynelson94/shipwright","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wynelson94%2Fshipwright","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wynelson94%2Fshipwright/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wynelson94%2Fshipwright/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wynelson94%2Fshipwright/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wynelson94","download_url":"https://codeload.github.com/Wynelson94/shipwright/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wynelson94%2Fshipwright/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31815083,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","app-builder","autonomous","claude-code","claude-code-plugin","no-code","vercel"],"created_at":"2026-04-14T21:03:25.334Z","updated_at":"2026-04-14T21:03:31.065Z","avatar_url":"https://github.com/Wynelson94.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shipwright\n\n**Describe your app. Get it deployed.**\n\nShipwright is a Claude Code plugin that builds complete web applications from plain English descriptions. No coding experience required — just describe what you want and Shipwright handles the rest.\n\n## Quick Start\n\n```bash\n# Install the plugin\nclaude plugin install shipwright\n\n# Build an app\n/shipwright:build \"a todo app with user accounts and dark mode\"\n```\n\nThat's it. Shipwright will:\n1. Understand your idea\n2. Design the app architecture\n3. Write all the code\n4. Run tests\n5. Deploy it live to Vercel\n6. Give you the URL\n\n## What Can It Build?\n\n\u003c!-- Stack info sourced from stacks/stacks-reference.md — update there first --\u003e\n| You Describe | Shipwright Builds |\n|-------------|------------------|\n| \"A project management tool\" | Full web app (Next.js + Supabase) |\n| \"A marketplace for freelancers\" | Complex app (Next.js + Prisma) |\n| \"A company blog\" | Content site (Astro) |\n| \"A simple dashboard\" | Lightweight app (SvelteKit) |\n\nRun `/shipwright:stacks` for full details on each stack.\n\n## Commands\n\n| Command | What It Does |\n|---------|-------------|\n| `/shipwright:build [idea]` | Build and deploy a new app |\n| `/shipwright:enhance [feature]` | Add features to an existing app |\n| `/shipwright:stacks` | See what kinds of apps Shipwright can build |\n| `/shipwright:projects` | List all apps you've built with Shipwright |\n\n## Setup\n\n### Requirements\n\n- [Claude Code](https://claude.ai/code) with an active Pro or Max subscription\n- [Node.js](https://nodejs.org) v20+ (v24 LTS recommended)\n- [Git](https://git-scm.com)\n- [Python 3.10+](https://python.org) (required for safety hooks and build engine)\n- [Vercel CLI](https://vercel.com/cli) (`npm i -g vercel`) + free Vercel account\n- [Supabase](https://supabase.com) account (free, only needed for apps with a database)\n- **Platform**: macOS or Linux (Windows is not currently supported)\n\n\u003e **No API key needed.** Shipwright runs entirely through your Claude Code subscription. You do not need an Anthropic API key or any paid API credentials.\n\n### Build Engine (Product Agent)\n\nShipwright uses Product Agent as its build engine. To install it automatically:\n\n```bash\nbash setup.sh\n```\n\nOr install manually:\n\n```bash\npip install product-agent\n```\n\nMinimum required version: **v12.0**\n\nShipwright checks for all requirements before building and walks you through installing anything that's missing.\n\n### Permissions\n\nFor the smoothest experience, allow these permissions in Claude Code settings:\n- `npm`, `npx`, `vercel` commands\n- Writing files to `~/Projects/`\n\nSee [CLAUDE.md](CLAUDE.md) for the full list of recommended permissions.\n\n## How It Works\n\nShipwright runs a 9-phase autonomous pipeline:\n\n```\nUnderstand → Design → Review → Build → Test → Audit → Deploy → Verify → Done!\n```\n\nEach phase runs independently with its own error recovery. If something goes wrong, Shipwright fixes it automatically (up to 5 attempts with backoff) and learns from mistakes.\n\n## Technology Stacks\n\nShipwright auto-selects the best technology for your app:\n\n| Stack | Best For | Key Features |\n|-------|----------|-------------|\n| **Next.js + Supabase** | SaaS, dashboards, user-facing apps | User accounts, database, realtime, file uploads |\n| **Next.js + Prisma** | Marketplaces, multi-tenant apps | Complex data relationships, advanced queries |\n| **SvelteKit** | Lightweight interactive apps | Blazing fast, minimal overhead |\n| **Astro** | Blogs, portfolios, docs sites | Fastest page loads, great SEO |\n\nAll stacks deploy to Vercel with zero configuration.\n\n## Safety \u0026 Security\n\nShipwright includes enterprise-grade safety features:\n\n- **Input sanitization** — Detects and strips 11 prompt injection patterns, zero-width unicode, HTML entities, and encoded attacks\n- **Command blocking** — Blocks destructive commands (`rm -rf /`, fork bombs, piped downloads, `sudo`, device writes) with shell-aware splitting\n- **Path protection** — Prevents writes to system directories (`/etc`, `/usr`, `/System`) and credential files (`.ssh`, `.aws`, `.pem`, `.key`, `.p12`)\n- **Audit logging** — Records all build activity with restrictive file permissions\n- **Build memory** — Learns from past builds with automatic log rotation (max 500 records)\n\nAll safety hooks run as bash scripts with python3 for comprehensive pattern matching, and fail-closed when python3 is unavailable.\n\n### Running the Hook Tests\n\n```bash\nbash tests/test_hooks.sh\n```\n\n41 tests covering bypass attempts, destructive commands, protected paths, and injection patterns.\n\n## Limitations\n\nAll Shipwright apps run on Vercel's serverless platform. This is great for most web apps, but there are some things to be aware of:\n\n- **No persistent WebSocket connections** — use Supabase Realtime or polling instead\n- **No background jobs over 5 minutes** — use Vercel Cron Jobs for scheduled tasks\n- **No server-side file storage** — use Supabase Storage or Vercel Blob for uploads\n- **250MB deployment size limit** — sufficient for most apps\n- **No GPU/ML inference** — use external APIs (Replicate, Modal) for AI models\n\nIf your idea needs any of these capabilities, Shipwright will work around the limitations or let you know upfront.\n\nAlternative deploy targets (Railway, Fly.io, etc.) are on the roadmap for future versions.\n\n## Built by Product Agent\n\nShipwright is powered by Product Agent v12.4 — an autonomous build pipeline with 1,544+ unit tests, 8 technology stacks, and battle-tested error recovery.\n\n## Version History\n\n| Version | Highlights |\n|---------|-----------|\n| **v2.3.0** | Enterprise security audit: hook bypass fix, review validation hardening, encoded attack detection, retry backoff, JSONL rotation, 41-test hook harness |\n| **v2.2.0** | Safety hardening, version pinning, project registry, docs overhaul |\n| **v2.1.0** | Background execution + polling, public release prep |\n| **v2.0.0** | Rewrite to use Product Agent CLI |\n| **v1.0.0** | Initial plugin with autonomous 9-phase pipeline |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwynelson94%2Fshipwright","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwynelson94%2Fshipwright","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwynelson94%2Fshipwright/lists"}