Skip to content

BiscayneDev/shipyard-os

Repository files navigation

npm version GitHub stars

⚓ Shipyard OS

The open-source operating system for AI agent teams.

Drag a task → your agents execute → the board reflects reality.

Get Started · Features · Demo · Roadmap



The Problem

You're running a company with AI agents — research, engineering, deals, treasury. But right now you're juggling:

Without Shipyard With Shipyard
Scattered agent outputs across Telegram, Slack, email One dashboard, all agents, all activity
No idea what your agents are working on Kanban board that updates in real time
Manually kicking off agent tasks Drag to "In Progress" → agent activates
No cost visibility until the bill arrives Per-agent budgets with approval gates
Copy-pasting context between tools Agents share memory, goals, and workspace

✨ Features

🗂 Kanban Task Board

Drag a task to "In Progress" and your agent picks it up. When it's done, the task moves to "Done" automatically. Budget checks and approval gates built in.

🤖 Agent Team Management

Five specialized agents out of the box — Chief of Staff, Scout (research), Builder (engineering), Deal Flow (partnerships), Baron (treasury). Add your own with custom roles, skills, and accent colors.

📊 Dashboard Command Center

Morning briefing in one glance: agent status (live pulsing dots), task summary, project health, recent intel, inbox, and goals — all on one screen.

💰 Budget Enforcement

Set monthly spend limits per agent. Shipyard checks budgets before activation and warns you when agents approach their limits. No surprise bills.

📂 GitHub Projects

CI status, open PRs, and deploy health for your pinned repos. Color-coded badges update automatically.

🔭 Intel Feed

Market intelligence reports from your Scout agent. Deploy research runs from the dashboard.

📅 Calendar & Inbox

Google Calendar events and important emails surfaced automatically. No more tab-switching.

🧠 Agent Memory

Browse your agents' memory files, daily notes, and long-term context. Everything is transparent.

💬 Agent Chat

Talk directly to your agents from the dashboard. Ask questions, give instructions, get status updates.

📱 Mobile Ready

Responsive design with bottom navigation. Manage your agent team from your phone.


🚀 Quickstart

One command:

npx create-shipyard-app

This will:

  1. Clone the repo
  2. Install dependencies
  3. Launch the setup wizard
  4. Open your browser

Or manually:

git clone https://github.com/BiscayneDev/shipyard-os.git
cd shipyard-os
npm install
npm run dev

Open localhost:3000 — the setup wizard walks you through connecting your agents.

With Ollama (local models):

git clone https://github.com/BiscayneDev/shipyard-os.git
cd shipyard-os
npm install
npm run dev

In the setup wizard, choose "Ollama / Local Models" and point it at your running Ollama instance. Works with LM Studio and llama.cpp too — anything that speaks the Ollama API.

Demo mode

Don't have agents set up yet? No problem. Click "Skip — explore without agents" in the setup wizard to get a feel for the dashboard with sample data.


🏗 How It Works

┌─────────────────────────────────────────────────────────┐
│                    SHIPYARD OS                          │
│                                                         │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐          │
│  │ Backlog  │───▶│In Progress│───▶│   Done   │          │
│  │          │    │          │    │          │          │
│  │ • Research│    │ 🔭 Scout │    │ ✅ Report │          │
│  │ • Build  │    │  running  │    │  ready   │          │
│  │ • Deploy │    │          │    │          │          │
│  └──────────┘    └────┬─────┘    └──────────┘          │
│                       │                                  │
│              ┌────────▼────────┐                        │
│              │  Budget Check   │                        │
│              │  Approval Gate  │                        │
│              └────────┬────────┘                        │
│                       │                                  │
│              ┌────────▼────────┐                        │
│              │  Agent Runtime  │                        │
│              │ OpenClaw/Ollama │                        │
│              └─────────────────┘                        │
└─────────────────────────────────────────────────────────┘
  1. You drag a task to "In Progress"
  2. Budget check runs — does this agent have spend remaining?
  3. Approval gate shows you the cost estimate — confirm or cancel
  4. Agent activates via OpenClaw gateway
  5. Task auto-moves to "Done" when the agent finishes
  6. Toast notification fires — activity logged to the feed

No polling. No manual follow-up. The board is the source of truth.


🧱 Stack

Layer Technology
Framework Next.js 16 (App Router)
Language TypeScript (strict mode)
Styling Tailwind CSS 4
Drag & Drop @hello-pangea/dnd
Agent Runtime OpenClaw, Ollama, or custom
Storage Vercel KV (prod) / local JSON (dev)
AI SDK Vercel AI SDK + Anthropic
Icons Lucide React
Deploy Vercel

🤖 Default Agent Team

Agent Role Color
🦞 Vic (Chief of Staff) Orchestrates the team, delegates tasks Purple
🔭 Scout Market intelligence, research, signals Cyan
Builder Engineering, shipping code, CI/CD Emerald
🤝 Deal Flow Partnerships, opportunities, outreach Amber
🏦 Baron Treasury, wallet ops, financial tracking Pink

Agents are fully customizable — change names, roles, skills, and colors from the Agents page.


📁 Project Structure

shipyard-os/
├── app/
│   ├── dashboard/      # Command center overview
│   ├── tasks/          # Kanban board with drag-to-activate
│   ├── agents/         # Agent team management
│   ├── projects/       # GitHub repos + CI status
│   ├── intel/          # Scout research reports
│   ├── calendar/       # Google Calendar integration
│   ├── chat/           # Direct agent chat
│   ├── settings/       # Config + reset wizard
│   ├── setup/          # First-run onboarding wizard
│   └── api/            # 15+ API routes
├── components/
│   └── Sidebar.tsx     # Desktop sidebar + mobile bottom nav
├── lib/
│   └── config.ts       # Runtime configuration
├── data/
│   ├── tasks.json      # Local task store
│   ├── agents.json     # Agent definitions
│   └── goals.json      # Goal tracker
└── public/

🗺 Roadmap

  • Kanban drag-to-activate with budget gates
  • Agent team management (CRUD)
  • Setup wizard with demo mode
  • Post-setup health checks
  • Budget enforcement + approval modals
  • Gmail inbox integration
  • Google Calendar integration
  • Agent runtime abstraction — plug in OpenClaw, Ollama, or custom runtimes
  • Agent marketplace — share and install agent identities
  • Cmd+K command palette — quick actions from anywhere
  • Webhooks — real-time updates instead of polling
  • Docker imagedocker run -p 3000:3000 shipyard-os
  • Multi-workspace — manage multiple agent teams
  • Mobile app — native iOS/Android companion

🤝 Contributing

We'd love your help making Shipyard OS better. See CONTRIBUTING.md for guidelines.

# Fork the repo, then:
git clone https://github.com/YOUR_USERNAME/shipyard-os.git
cd shipyard-os
npm install
npm run dev

❓ FAQ

Do I need OpenClaw to use this?
No! Shipyard OS supports multiple runtimes: OpenClaw for full agent orchestration, Ollama/LM Studio/llama.cpp for local models, or demo mode to explore without any runtime.
Is this just a dashboard?
No — it's an operating system. When you drag a task to "In Progress", it actually fires an agent. Budget gates prevent runaway costs. The board reflects what your agents are doing in real time.
Can I use my own agents instead of the defaults?
Yes. Add, edit, or delete agents from the Agents page. Each agent is a markdown identity file in your workspace — fully customizable roles, skills, and personalities.
What about costs?
Shipyard OS tracks per-agent token usage via the Anthropic Admin API. Set monthly budgets per agent, and the system will block activation when limits are reached. No surprise bills.
Can I self-host this?
Yes. It's a standard Next.js app. Run it locally, deploy to Vercel, or host anywhere that supports Node.js. Task storage uses local JSON in dev and Vercel KV in production.

📄 License

MIT — use it, fork it, ship it.


Built by

Halsey Huth — building in public.

Powered by OpenClaw.


If Shipyard OS helps you run your agent team, give it a ⭐

About

The open-source Agent OS for solo founders. Connect your AI agents, manage tasks, monitor projects — all in one command center.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors