Portable Development System

Terminal-first, AI-assisted development. Worktrees for isolation. Skills for consistency.

"Simplicity is prerequisite for reliability." — Edsger Dijkstra

---

The Problem

• IDEs are bloated
• Context switching kills flow
• git stash is where work goes to die
• Every project has different conventions

The Fix

• Terminal + Claude Code as your primary interface
• Worktrees for true branch isolation
• Skills that encode your team's best practices
• One setup across all projects

---

Quick Start

# 1. Install dependencies
brew install yazi zoxide fzf ripgrep fd bat starship tmux lazygit

# 2. Run installer
curl -fsSL https://raw.githubusercontent.com/rmzi/portable-dev-system/main/install.sh | bash

# 3. Add skills to your project
cd ~/your-project && pds-init

---

Key Commands

Command	What it does
wt / wty	Open worktree in tmux layout (Claude + terminal + yazi)
wts	Global session picker - jump to any tmux session
wta -b feature/x	Create new worktree + branch
pds-init	Install skills to current project
pds-update	Update skills to latest version
clauder	Resume Claude session

Skills: /commit /review /debug /test /design /worktree

---

Docs

Topic	Link
Skills catalog	docs/skills.md
Command reference	docs/commands.md
Installation details	docs/install.md
Team setup	docs/teams.md
Philosophy	docs/philosophy.md

---

For Teams

# Add to your repo
pds-init && git add .claude CLAUDE.md && git commit -m "Add PDS skills"

Every team member gets the same:

• Code review checklist (/review)
• Commit conventions (/commit)
• Debugging protocol (/debug)

No more "how do we do X here?" — it's in the skills.

Full team setup →

---

Permissions Model

PDS includes a velocity-focused .claude/settings.json — like --dangerously-skip-permissions but with guardrails.

Auto-allowed: all tools, bash, MCP, web fetches

Blocked:

• Credential paths (~/.aws, ~/.ssh, ~/.gnupg)
• Git push to main/master/dev/develop
• Force push, ssh, scp
• Prod patterns (PROD, prod., --profile prod)

Full permissions docs →

---

Contributing

PRs welcome. Add skills, improve docs, share what works.

wta -b feature/my-improvement
# Make changes
# /commit for the format

---

MIT — use it, fork it, make it yours.