https://github.com/ship-studio/ship-studio
The professional studio for modern development — build it, ship it, host it without leaving the app. Free, local-first, works with Claude Code / Codex / OpenCode.
https://github.com/ship-studio/ship-studio
ai-agents claude-code desktop-app developer-tools react rust tauri
Last synced: 6 days ago
JSON representation
The professional studio for modern development — build it, ship it, host it without leaving the app. Free, local-first, works with Claude Code / Codex / OpenCode.
- Host: GitHub
- URL: https://github.com/ship-studio/ship-studio
- Owner: ship-studio
- License: mit
- Created: 2026-01-16T14:34:15.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-06-11T18:14:01.000Z (10 days ago)
- Last Synced: 2026-06-11T20:08:26.868Z (10 days ago)
- Topics: ai-agents, claude-code, desktop-app, developer-tools, react, rust, tauri
- Language: TypeScript
- Homepage: https://www.ship.studio
- Size: 8.89 MB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Ship Studio
[](https://github.com/ship-studio/ship-studio/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.ship.studio/download)
**The professional studio for modern development.**
Build it, ship it, host it — without leaving the app.
Ship Studio is a **free desktop app** that puts everything you need for
agentic development in one window: an AI agent terminal, a live preview,
visual editing, Git branches and PRs, and one-click deploys. Plug in the
agent and accounts you already pay for — Claude Code, Codex, or OpenCode;
GitHub; Vercel — and start shipping.
The web is changing, and freelancers, agencies, and designers are trying to
stay up to speed. Ship Studio is the easiest path to modern development: all
the simplicity of the all-in-one tools you're used to, **without the
lock-in**. It's a real desktop app that runs locally on your Mac — your code
lives on your machine, not on our servers.
*Dev tools for the rest of us.*
[**Download for free**](https://www.ship.studio/download) · [Website](https://www.ship.studio/) · [Community Slack](https://join.slack.com/t/shipstudiocommunity/shared_invite/zt-3ommmu2w4-jtYZzzc9T~9lsEeKQ4E2AQ) · [Follow @galluzzo_julian](https://x.com/galluzzo_julian)
---
## Why Ship Studio
- **Truly free.** No account, no Ship Studio subscription on top. Bring the
agent and hosting accounts you already have.
- **No lock-in.** It's your repo, your machine, your hosting. Stop using
Ship Studio tomorrow and you keep everything.
- **One window.** Agent, preview, branches, deploys — no tab-juggling
between a terminal, an editor, GitHub, and a hosting dashboard.
## What you get
- **AI Agent Terminal** — Claude Code, Codex, or OpenCode built in, with
multi-tab and side-by-side agent panes.
- **Live Preview** — Real-time preview with responsive breakpoints, zoom,
fullscreen mode, and a locale switcher for multilingual projects.
- **Visual Editing** — Select an element, change it, write custom CSS —
without burning AI credits. Pinnable editor panel and a Webflow-style
element tree in fullscreen.
- **Mobile App Preview** — Build and mirror Expo, React Native, and Flutter
apps on the iOS simulator, right in the workspace.
- **GitHub Integration** — One-click repo creation, publishing, PR
submission with AI-generated titles/descriptions, and a merge-conflict
resolution UI.
- **Deploys** — Push to staging or production on Vercel with one click;
auto-deploys on every push.
- **Projects Dashboard** — Visual cards with automatic screenshot
thumbnails, folders, pinned hot sessions, and multi-window support.
- **Snapshots & Backups** — Create and restore project snapshots when an
agent goes off the rails.
- **Command Palette** — Cmd+K for every action in the app.
- **Starter Templates** — Next.js, SvelteKit, Astro, Nuxt, plain
HTML/CSS/JS — plus Expo, React Native, and Flutter mobile starters.
- **Plugins, Skills & MCP** — Extend the app with plugins, install agent
skills, and configure MCP servers.
- **Env Editor, IDE Launcher, Monorepo Support, Auto-Updates** — the
unglamorous stuff, handled.
## Install
Grab the latest release from
[ship-studio/releases](https://github.com/ship-studio/releases/releases/latest):
| Platform | Download |
|----------|----------|
| macOS (Apple Silicon) | `Ship.Studio__aarch64.dmg` |
| macOS (Intel) | `Ship.Studio__x64.dmg` |
| Windows (x64) | `Ship.Studio__x64-setup.exe` |
Launch the app and the onboarding wizard takes it from there — it installs
the system prerequisites (Node, Git, GitHub CLI, an AI agent CLI) for you.
See [docs/INSTALLATION.md](docs/INSTALLATION.md) for the full guide.
Official builds auto-update: the app checks on launch and hourly, then
applies updates with one click. Recent changes live in
[RELEASE_NOTES.md](RELEASE_NOTES.md).
## Build from source
Prerequisites: [Node 22](https://nodejs.org) (see [`.nvmrc`](.nvmrc)),
[pnpm](https://pnpm.io), [Rust stable](https://rustup.rs/), and on macOS the
Xcode Command Line Tools (`xcode-select --install`).
```bash
git clone https://github.com/ship-studio/ship-studio.git
cd ship-studio
pnpm install
pnpm tauri dev # run in development mode
pnpm tauri build # production build → src-tauri/target/release/bundle/
```
## How it's built
| Layer | Technology |
|-------|------------|
| Frontend | React 19, TypeScript, Vite |
| Backend | Rust, Tauri 2 |
| Terminal | xterm.js + tauri-pty |
| Styling | CSS design tokens (dark theme) |
```
ship-studio/
├── src/ # React frontend
│ ├── components/ # UI components (incl. setup/, edit/, primitives/)
│ ├── lib/ # Tauri command wrappers & utilities
│ ├── hooks/ # Custom React hooks
│ ├── commands/ # Cmd+K palette registry
│ ├── contexts/ # Modal, toast, and other app contexts
│ └── styles/ # CSS (global tokens, features, modes)
├── src-tauri/ # Rust backend
│ └── src/commands/ # Tauri commands by domain:
│ # git/ projects/ setup/ pty/ plugins/ skills/
│ # health/ ide/ + mobile, edit, publishing,
│ # github, conflicts, snapshots, i18n, …
├── docs/ # Contributor & forking docs
└── packages/plugin-sdk/ # Plugin SDK
```
The backend exposes its functionality as Tauri commands registered in
[`src-tauri/src/lib.rs`](src-tauri/src/lib.rs); the frontend calls them
through typed wrappers in [`src/lib/`](src/lib/). For the full architecture
tour, read [CLAUDE.md](CLAUDE.md) — it's the same guide AI agents use to
work on this codebase.
## Contributing
We'd love your help — and we've tried to make it **absurdly easy** for both
humans and AI agents to contribute:
1. Read [CONTRIBUTING.md](CONTRIBUTING.md) — setup, CI gates, and the PR process.
2. Skim [docs/CONTRIBUTING_PATTERNS.md](docs/CONTRIBUTING_PATTERNS.md) — the
shared primitives (``, ``, `useInvoke`, design
tokens, `CommandError`) that keep the codebase consistent.
3. Working with an AI agent? It will pick up [CLAUDE.md](CLAUDE.md) /
[AGENTS.md](AGENTS.md) automatically and follow the house patterns.
Before pushing, run the same gates CI runs:
```bash
pnpm check:all && pnpm test:run && pnpm rust:test
```
Want to fork and ship your own distribution instead? See
[docs/FORKING.md](docs/FORKING.md).
## Privacy & telemetry
Official builds send anonymous usage events to the maintainers'
[PostHog](https://posthog.com/) project and crash reports to
[Sentry](https://sentry.io/). Every event is documented in
[docs/analytics.md](docs/analytics.md).
Disable analytics any time from inside the app (**Settings → Usage
analytics**) — the setting persists and the Rust backend short-circuits all
sends, crash reports included. Building your own distribution? See
[docs/FORKING.md → Telemetry](docs/FORKING.md#5--telemetry) to swap in your
own keys or strip telemetry entirely.
## Security
Found a vulnerability? **Do not file a public issue.** See
[SECURITY.md](SECURITY.md) for private reporting.
## Community
- [GitHub Discussions](https://github.com/ship-studio/ship-studio/discussions) — questions, ideas, show-and-tell
- [Community Slack](https://join.slack.com/t/shipstudiocommunity/shared_invite/zt-3ommmu2w4-jtYZzzc9T~9lsEeKQ4E2AQ) — real-time chat with maintainers and users
- [Issues](https://github.com/ship-studio/ship-studio/issues) — bug reports and feature requests
- [@galluzzo_julian](https://x.com/galluzzo_julian) — follow along on X
## License
[MIT](LICENSE) © Julian Galluzzo and Ship Studio contributors.