PortOS

<p align="center">
  <img src="./docs/media/portos-logo.png" alt="PortOS logo" width="160" />
</p>

<h1 align="center">PortOS</h1>

**Your self-hosted operating system for dev machines.** Manage apps, orchestrate AI agents, build your digital twin, capture knowledge, and track your health — all from a single dashboard accessible anywhere via [Tailscale](https://tailscale.com).

Think [Umbrel](https://umbrel.com), but for your active git repos, AI workflows, and personal knowledge. Access everything from your phone, tablet, or any device on your Tailscale network.

> **Highly opinionated & personal.** PortOS is built for one specific use case: a single developer running it on their own machine, behind Tailscale, with their own AI providers and workflows. It makes strong assumptions about how you work and will keep making them. Pull requests are welcome — but the project will always prioritize the author's needs first, and merges may introduce breaking changes without warning. If something stops working after an update, ask your coding agent of choice to read the changelog and upgrade your local data: `"Read .changelog/vX.Y.Z.md and fix any migration issues in my PortOS data/ directory."`

![PortOS Chief of Staff](./docs/media/portos_1.png)

---

## Why PortOS?

Most developers juggle a dozen tools — PM2 terminals, JIRA boards, AI chat windows, note apps, health trackers. PortOS unifies them into a single local-first dashboard that runs on your dev machine and travels with you over Tailscale.

- **One dashboard** for all your apps, agents, and knowledge
- **AI agents that work while you sleep** — autonomous task execution with multi-model orchestration
- **Your identity, quantified** — genomics, chronotype, taste profiling, and mortality-aware goal tracking
- **Second brain included** — capture thoughts, auto-classify them, and surface insights with daily digests
- **Mobile-first design** — manage your entire dev environment from your phone

---

## Screenshots

| Chief of Staff | AI Agents | AI Providers |
|:-:|:-:|:-:|
| ![Chief of Staff](./docs/media/portos_1.png) | ![AI Agents](./docs/media/portos_2.png) | ![AI Providers](./docs/media/portos_3.png) |

| App Wizard | PM2 Processes | Chief of Staff Tasks |
|:-:|:-:|:-:|
| ![App Wizard](./docs/media/portos_4.png) | ![PM2 Processes](./docs/media/portos_5.png) | ![Chief of Staff Tasks](./docs/media/portos_6.png) |

---

## Features

### App Management

Bring your entire portfolio of projects under one roof.

- **Dashboard** — Grid of app tiles with real-time status, port links, start/stop/restart controls, and system health monitoring
- **Smart Import** — Point to a directory and auto-detect project config from `package.json`, `vite.config`, and `ecosystem.config` ([App Wizard docs](./docs/features/app-wizard.md))
- **App Templates** — Scaffold new projects from pre-built templates with AI provider integration
- **Real-time Logs** — Stream PM2 logs via Socket.IO with tail length control
- **JIRA Integration** — Per-app board config, active sprint resolution, epic search, and ticket creation from the UI ([Sprint Manager docs](./docs/features/jira-sprint-manager.md))
- **Autofixer** — Autonomous crash detection and repair: polls PM2 for errored processes, invokes AI to diagnose and fix, tracks attempts with cooldowns ([Autofixer docs](./docs/features/autofixer.md))

### Chief of Staff (CoS)

An autonomous AI agent orchestrator that manages your development workflow. Submit a task, and CoS dispatches the right AI agent to handle it — then learns from the result. ([Full docs](./docs/features/chief-of-staff.md))

- **Multi-Agent Orchestration** — Run Claude Code, Codex, Gemini CLI, Ollama, and LM Studio concurrently with global and per-project limits, capacity management, and fair scheduling ([Agent Runner docs](./docs/features/cos-agent-runner.md))
- **Intelligent Routing** — 6 agent skill templates (bug-fix, feature, security-audit, refactor, docs, mobile) route tasks to the best model based on complexity ([Agent Skills docs](./docs/features/agent-skills.md))
- **Task Learning** — Tracks success rates, error patterns, and model performance to dynamically improve routing decisions ([Memory System docs](./docs/features/memory-system.md))
- **Goal Tracking** — Define goals and track progress across hundreds of completed tasks with success rate metrics
- **Scheduled Automation** — Cron-based self-improvement and app-improvement jobs with per-app interval overrides
- **Error Recovery** — 6 strategies (retry, escalate, fallback, decompose, defer, investigate) for automatic diagnosis and retry ([CoS Enhancement docs](./docs/features/cos-enhancement.md))
- **Hybrid Memory Search** — BM25 + vector search with Reciprocal Rank Fusion for semantic retrieval across agent history
- **Productivity Analytics** — Work streaks, hourly/daily patterns, milestones, and AI-generated weekly digests
- **Decision Transparency** — Every skip, switch, and routing decision is logged with re

... (truncated)