hironow@mac ~/dotfiles ❯ cat README
~/dotfiles
A reproducible developer environment built on Zsh, mise, just, and uv that also runs a solo operator's agent fleet: one hub-and-spoke instruction set for five agent CLIs, 141 declared skills, and a complete local-dev stack with datastore and SaaS emulators, OpenTelemetry, and stable https://*.localhost routing. Agents build, gates verify, a human approves.
# runs on macOS, Linux, WSL, and native Windows. MIT. revised 2026-09-07 by hironow
hironow@mac ~/dotfiles ❯ bash -c "$(curl -fsSL https://raw.githubusercontent.com/hironow/dotfiles/main/install.sh)"
# macOS, Linux, WSL: Homebrew or apt, then mise pins every tool. Already cloned? just install, or just deploy to relink this host.
PS C:\> irm https://raw.githubusercontent.com/hironow/dotfiles/main/bootstrap.ps1 | iex
# native Windows: scoop, git, just, mise, then the same deploy. Idempotent; safe to run again.
hironow@mac ~/dotfiles ❯ mise ls
| tool | notes |
|---|---|
| zsh | Sheldon plugins, Starship prompt |
| mise | one config.toml pins the same versions on every machine |
| just | the only entrypoint: 141 recipes in 20 groups |
| uv | packages and venvs, resolved through a malware-scanning mirror |
| bun | the only Node package manager; npm, yarn, and pnpm are blocked by a hook |
| prek | format, lint, and semgrep gates before every commit |
| ruff, semgrep | guardrail rules with co-located fixtures, self-tested in CI |
| agent CLIs | claude, codex, gemini (antigravity), copilot, pi, pinned like any other tool |
| fzf, ghostty | fuzzy everything, GPU-accelerated terminal |
hironow@mac ~/dotfiles ❯ just emu-start && just tel-up && portless proxy start
| stack | what comes up |
|---|---|
| emulator | the GCP core by default: Firebase, Spanner with pgAdapter, Postgres |
| emu-up-full | plus Bigtable, Neo4j, Qdrant, Elasticsearch, MLflow, and the A2A and MCP inspectors |
| telemetry | otel-collector into Tempo, Loki, Prometheus, and Grafana |
| emulate | GitHub, Google, Slack, Apple, Microsoft, Stripe, Clerk, Okta, Resend on :4100 to :4108 |
| portless | every HTTP UI at https://<name>.localhost behind a trusted local CA |
# everything is vendored and version-pinned; the dev container and CI run the same stack
hironow@mac ~/dotfiles ❯ just sync-agents all && just skills-place
| instructions | one base, one Claude overlay, 14 on-demand spokes, 4 hooks, distributed to 7 agent homes |
| skills | 141 declared in one lock file; 44 self-authored in hironow/skills, each with its provenance and upstream credit; homes link into one store |
| plugins | autodesign, autoresearch, autoreview, grilling |
| doctrine | TDD (red, green, refactor), Tidy First, Conventional Commits, semgrep guardrails, 43 ADRs |
| gates | Claude Code hooks, prek, and CI hold the rules whatever an agent decides |
hironow@mac ~/dotfiles ❯ grep GRIT ROOT_AGENTS.md
| G | Guts | hit the scariest unknown first; say plainly what is unknown |
| R | Resilience | a failure means change the hypothesis and retry, never hand back half |
| I | Initiative | take the obvious next step unprompted; confirm the irreversible |
| T | Tenacity | define done concretely and grind to it, proven |
hironow@mac ~/dotfiles ❯ just --list
| install | bootstrap the full environment on a fresh machine |
| deploy | symlink dotfiles onto this host (idempotent) |
| doctor | check the machine: PATH shadows, missing tools, rogue installs |
| sync-agents | distribute instructions, hooks, and settings to the agent homes |
| restore-skills-lock | install every declared skill into the store, then link the homes |
| ci | the fast gate: format, lint, semgrep self-tests, unit tests, IaC (no docker) |
| test | the dev container sandbox suite (tracked files only, nothing mounted) |
| emu-start, tel-up | bring the local stacks up; emu-stop, tel-down take them down. Register the portless aliases from docs/portless-urls.md before opening their URLs |
hironow@mac ~/dotfiles ❯ just ci && just test
✅ ci (fast gate) passed
✅ 141 passed in the dev container sandbox
hironow@mac ~/dotfiles ❯