Tuidev

tuidev — macOS terminal dev setup

Opinionated, terminal-first developer environment built around **tmux durability**, **sandboxed AI agents**, and **layered installation**.

[](https://github.com/spfr/tuidev/actions/workflows/ci.yml)   

What this is

A small, opinionated set of configs + install scripts for an AI-assisted coding workflow. Three ideas shape it:

1. One session, one pane, one task. Your work has to survive disconnects, narrow terminals, and mobile reattaches. tmux is the durability layer; splits are a local bonus, not the story.
2. Sandbox-ready. sbx runs any command inside macOS Seatbelt; install --pack ai-clis and your AI CLIs route through it automatically. Credentials (~/.ssh, ~/.aws, keychain) are locked out even if the agent is compromised.
3. Layered install. Pick a profile (minimal, desktop, remote) or compose packs (--core, --remote, --sandbox, --ui, --extras, --pack zellij, ...). Your ~/.zshrc is never overwritten — edits outside the tuidev-managed block survive forever. macOS is the daily driver; minimal and remote also install on Debian/Ubuntu, falling back to apt where Homebrew has no build (arm64 boards like a Raspberry Pi included).

Quick start

git clone https://github.com/spfr/tuidev.git
cd tuidev
./install.sh --profile desktop    # or: minimal | remote
exec zsh -l

work myproject                    # bare tmux session, attach-or-create
dev                               # nvim | agent | runner
ai                                # nvim + 2 work panes
sbx -- some-cmd                   # run anything under Seatbelt

./install.sh --pack ai-clis       # opt-in: cc/cx/oc wrappers for AI CLI