Ship

Ship faster with AI that codes with you

Get Started · Documentation · Report Bug · Request Feature

---

From Prototype to Production in One Place

Built on the platform trusted by over 150 million developers, Ship gives you the smoothest path from idea to deployment.

Note

Ship is an autonomous AI coding agent that works directly in your GitHub workflow.

---

Table of Contents

• About
• Features
• Getting Started
• Architecture
• Roadmap
• Contributing
• License

---

🚀 About

Ship assigns issues directly to AI and lets it autonomously write code, create pull requests, and respond to feedback — all in the background.

From edits to pull requests, the world's best coding agents work beside you so nothing slows you down.

Build and Iterate Your Way

Natural language, clickable controls, or code—use whatever feels right. Live preview updates instantly as you build.

Input Method	Description
Natural Language	Describe what you want in plain English
Clickable Controls	Use intuitive UI to guide the AI
Code	Write code directly when you prefer
Live Preview	See changes instantly as you build

---

🔒 Secure and Ship Quality Code

Important

Deploy with confidence as Ship helps you find and fix vulnerabilities in real time.

✨ Dream it. See it. Ship it. ✨

Security Feature	Description
Vulnerability Detection	Find security issues before they reach production
Real-time Fixes	Get instant suggestions to fix vulnerabilities
Code Quality	Automated code review and best practices
Dependency Scanning	Monitor and update dependencies safely

---

⭐ Features

Feature	Description
🤖 Issue Assignment	Assign issues directly to Ship
💻 Autonomous Coding	AI writes code based on requirements
🔀 Auto PR Creation	Creates well-formatted pull requests
💬 Feedback Response	Responds to code review comments
🧠 Multi-Provider LLM	OpenAI, Claude, Groq, Ollama support
🚀 One-Click Deploy	Transform ideas to deployed apps instantly

View All GitHub Actions Workflows

Workflow	Description	Trigger
Ship Agent	Process assigned issues with AI	issues.assigned
Code Review	AI-powered code review	pull_request
Security Scan	Find vulnerabilities in real time	push
Auto Deploy	Deploy on merge to main	push to main
Test Runner	Run tests on PR	pull_request

---

🏗️ Architecture

flowchart TD
    A[GitHub Events] --> B[Issue Processor]
    B --> C[Code Generator]
    C --> D[Security Scanner]
    D --> E[PR Manager]
    E --> F[One-Click Deploy]
    
    style A fill:#312E81,stroke:#8B5CF6,color:#fff
    style B fill:#312E81,stroke:#8B5CF6,color:#fff
    style C fill:#312E81,stroke:#8B5CF6,color:#fff
    style D fill:#312E81,stroke:#8B5CF6,color:#fff
    style E fill:#312E81,stroke:#8B5CF6,color:#fff
    style F fill:#312E81,stroke:#8B5CF6,color:#fff

Loading

View Tech Stack

	Technology	Purpose
⚡	Vercel AI SDK	Unified LLM interface
⚛️	Next.js 14	Frontend & API routes
📘	TypeScript	Type-safe development
🐙	GitHub API	Issue & PR management
🔒	Security Scanner	Vulnerability detection
🗄️	Supabase	Database (optional)

---

📦 Getting Started

Prerequisites

Warning

Ensure you have the following installed before proceeding.

node >= 18.0.0
npm >= 9.0.0

Installation

1. Clone the repository

   git clone https://github.com/likhonsex/Ship.git
   cd Ship

2. Install dependencies

   npm install

3. Configure environment

   cp .env.example .env

4. Start development server

   npm run dev

Environment Variables

Variable	Required	Description
GITHUB_TOKEN	✅	GitHub access token
OPENAI_API_KEY	✅1	OpenAI API key
ANTHROPIC_API_KEY	➖	Claude API key
GROQ_API_KEY	➖	Groq API key

---

🗺️ Roadmap

• Core issue processor
• AI code generation
• GitHub Actions integration
• Security vulnerability scanning
• Live preview updates
• Multi-provider LLM support
• Advanced PR management
• Feedback loop automation
• One-click deploy integration
• VS Code extension

See the open issues for a full list of proposed features.

---

🤝 Contributing

Tip

Contributions make the open source community an amazing place to learn, inspire, and create.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See AGENTS.md for agent development guidelines.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

💖 Support

---

From Prototype to Production

✨ Dream it. See it. Ship it. ✨

Built on the platform trusted by over 150 million developers

GitHub · Issues · Discussions

Footnotes

1. At least one LLM provider key is required. ↩